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Background and Summary of the Invention 

The present application relates to telecommunication systems, 
and particularly to element management systems which remotely 
10 manage telecommunications network elements. 



Background; Telecommunications Network Structure 

The advance of modern telecommunications technology, and the 
increasing use of data bandwidth by many businesses, has resulted in 
an increasing amount of traffic flowing to an increasing number of 

15 nodes. The data bandwidths which can be handled by fiber optic lines 
have made long-distance data transmission much cheaper, but have 
required complex electronics for combining substreams of data and 
routing each to its proper destination. The telecommunications 
infrastructure includes a wide variety of network elements, each of 

20 which may include a number of complex programmable subsystems. 
With the explosive growth in technological capabilities, many vendors 
have been making rapid improvements in their network element 
components. 

Telecommunications networks are complex to design, build, and 
25 maintain. Ever increasing demands for improvements, greater 
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bandwidth, ease of use, and interoperability add to this complexity and 
require increasingly capable network management. Service providers 
require network management systems that can accommodate equipment 
and components that comply with a variety of interface standards. 

Background; Developments in Diversity of Network Elements 

It should be noted that the terms "network element" and "element 
manager" are also sometimes used in reference to computer networks 
rather than telecommunications networks. However, the requirements 
for element management in such networks are vastly different from 
those relevant to telecommunications networks. First, telecommunica- 
tions networks are normally have a far larger number of nodes. 
Second, data stream routing is the primary purpose of telecommunica- 
tions networks, while in computing networks switching is performed 
merely when required to link resources demanded by a particular task. 
(Indeed a WAN will typically be implemented using data channels 
provided by a telecommunications network operator, so it can be seen 
that the telecommunications network, in such cases is regarded as a 
more "fundamental" level on which the connectivity of the WAN can 
be allowed to depend.) Third, the reliability requirements of telecom- 
munications networks are extremely high, and can be much higher than 
those of some computer networks. Fourth, a telecommunications 
network typically includes far more nodes which are physically remote. 
Fifth, the ratio of processor operations to data bits transmitted is 
typically different by many orders of magnitude. 

The network elements are each a complex system which includes 
many complex programmable subsystems. These programmable 
subsystems have local memories which store their programming and 
maintain a record of their operating history. The data in these many 
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local memories is important for auditing system integrity and reliabili- 
ty- 

Background; Element Management Systems (EMSs) 

Element management systems are used by telecommunications 
5 system operators to monitor telecommunications network elements, and 
change signal switching and routing as required. Conventionally a 
single "network element" is considered to include a number of 
independently programmable switching cards (typically one or more 
shelves full, i.e. tens of cards). Since each card is itself a complex 

10 programmable system, the total programmability of a modern network 
element is very large. 

Element management is not a trivial task, since each network 
element includes many complex programmable subsystems, and since 
very high reliability is required. Element management is rapidly 

15 becoming more difficult, since the number of possible programmed 
states in each network element is steadily increasing. 

For example, a typical card might have four bidirectional OC-3 
interfaces, for a total bandwidth of more than half a gigabaud in each 
direction. Each OC-3 data stream is resolved into three STS-1 data 

20 streams, which in turn are each resolved into 28 data streams at Tl rate 
(approximately 1.5 million bits per second each). Thus the card can 
redirect 84 different channels within each of its four data connections. 
Even without cross-connect options, the theoretically possible number 
of in/out switching states is 336 factorial (336x335x334x...x3x2xl). 

25 The theoretically possible number of switching states for a network 
element which includes 30 such cards will be in the neighborhood of 
this number raised to the 30th power, which is a very large number (of 
the order of lO^'^^S). 
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As the demand for bandwidth increases, hierarchical switching 
relations are appearing. For example, currently proposed WDM cards 
would handle routing of 168 OC-192 channels, each carrying about 10 
gigabaud (ten billion bits per second). Each of those OC-192 data 
5 streams would then be further manipulated by an OC-192 switching 
card, which would divide the OC-192 data streams down into (for 
example) OC-3 data streams, for routing to an OC-3 switching card. 
(For comparison, ordinary voice connections require only about 56 
kilobits per second each, which is much smaller than the smallest data 

10 channel of the OC-3 card mentioned above.) 

An opposite trend, which also makes element management more 
difficult, is the larger size of networks. Telecommunications networks 
underwent a fundamental change in their locational economics in the 
last decades of the 20th century. This change began when microwave 

15 links replaced copper, but in recent years has been driven by the very 
high bandwidths provided by fiber optic trunk lines. In this new era 
of locational economics, the physical distance between signal origina- 
tion and destination points became much less important than it had been 
previously; and a corollary of this was that economies of scale drove 

20 telecommunications networks to increasingly larger sizes (whether 
measured geographically, or by numbers of nodes, or by bandwidth 
switched). 

The trend to larger networks has also been driven by the 
increasingly global span of telecommunications carriers. Large carriers 
25 have networks which extend over tens of thousands of miles, and they 
need reliable tools for monitoring and controlling these very large and 
very far-flung networks. 

The larger sizes of networks, in turn, mean that a state-of-the-art 
network element management system must be able to cope with 
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thousands of network elements, each containing tens of cards which 
each are programmable to switch hundreds of channels. 

A further pressure on element management systems is applied by 
customer demand for fast response: a corporate user of bandwidth 
5 which requests additional capacity will be severely hampered if the 
response is not prompt. 

The telecommunications network is never static, but is continual- 
ly changing, in response to operator inputs as well as to equipment 
changes. Conventionally the operator inputs which conmiand changes 
10 have been stored in a log file; but this results in a large text file which 
is extremely difficult to search. While in theory such a large text file 
can be searched for debugging or to ascertain the current state, in 
practice the present inventors have found that this is difficult. 

Conventional element management systems (EMSs) have been 
15 vendor-specific, so that a network management system must interface 
to multiple different EMSs. (A model of this interface structure is 
shown in Figure lA.) 

Background: Cross-Connect Management 

The number of links in a complex cross-connect cannot usefully 
20 be viewed at once, so an operator interface for cross-connect manage- 
ment must provide some way to reduce the number of links seen at 
once. This is typically done by using multiple windows to view 
different subsets of links in detail. However, the increasing number of 
windows means the operators have more difficulty in bringing up the 
25 appropriate display view to see the selected link in detail. 

Background: Network. Service, and Business Management; 
TMN 
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The TMN architecture is a reference model for a hierarchical 
telecommunications maWgement approach. Its purpose is to partition 
the functional areas on management into layers. See e.g. ITU-T 
Recommendation M.301CI; Divakara K. Udupa, TMN: Telecommuni- 
5 cations Management NeWork (1999); and the Internet-published 
tutoria\l articles 
http://www.webproforiMn.com/acrobat/fund_telecom.pdf, 
http://www.webproi\prum.com/acrobat/oss.pdf, 
http://www.webpro f oV um.com/acrobat/tmn.pdf, 
10 http://www.webproforum.com/aWobat/ems.pdf; all of which are hereby 
incorporated by reference. \ 

The TMN architecture identifies five functional levels of 
telecommunications management: business management layer (BML), 
service management layer (SML), network management layer (NML), 
15 element management layer (EML), and the (increasingly intelligent) 
NEs in the network element layer (NEL). TMN segregates (or at least 
distinguishes) the management responsibilities based on these layers. 
This makes it possible to distribute these functions or applications over 
the multiple disciplines of a service provider and use different operating 
20 systems, different databases, and different programming languages. In 
the TMN architecture, the element management layer is the only low- 
level interface to the network elements, but needs to give the higher 
layers smooth access to information about the network elements. 

Background: CORBA 

25 One important component of the software architecture for 

modern teleconmiunications has been the object-oriented software 
relations defined by CORBA (Common Object Request Brokered 
Architecture). This standard is particularly useful in telecommunica- 

App*n of Fujitsu Network Communications, Inc.: FN-3014 Page 6 



A 



4 

tions, where it provides a basic framework for interfacing between 
element management functions and other functions (e.g. network 
management software and system management software functions). 

Background: Optical Telecommunications Standards and 
5 Terminology 

The role of telecommunications network management is changing 
due to new requirements for speed, increased bandwidth, and capacity 
to carry video, digital, and internet data. To provide the needed 
functions, protocols such as ATM, SONET, and SDH are emerging. 

10 Network management systems must accommodate these new technolo- 
gies and standards. 

The demand for bandwidth has driven many service providers to 
use optical conmiunication systems. A typical set of standards for 
optical synchronization and interconnectivity is SONET (Synchronous 

15 Optical Network). SONET is a family of fiber-optic transmission rates 
designed to transport many digital signals with different capacities and 
to provide a design standard for manufacturers. These design standards 
provide an optical interface that allows interoperating of transmission 
products from different multiple vendors, supports new broadband 

20 services, and allows enhanced OAM&P (Operations, Administration, 
Maintenance, and Provisioning). 

SONET has a base rate of 51.84 Mbps, with higher rates being 
multiples of the base rate. The architecture has four layers, these 
layers being topped by ATM (Asynchronous Transfer Mode) layers. 

25 The photonic layer is the physical layer and includes specifications for 
the fiber optics, transmitter characteristics (such as dispersion of the 
transmitter), and receiver characteristics (such as sensitivity). The 
section layer converts electric signals to photonic signals and creates 
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SONET frames. The line layer performs functions such as synchroni- 
zation, multiplexing of data to SONET frames, switching, etc. The 
path layer performs end to end transport of data. 

Open Systems Interconnection (OSI) is an internationally 
accepted framework for conmiunication standards between different 
systems made by different vendors. The OSI model is designed to 
create an open system networking environment where any vendor's 
computer system can freely share data with other systems on the 
network. The model organizes the communication process into seven 
different categories and places these categories in a layered sequence 
based on their relation to the user. Layers 7-4 deal with end to end 
communications, and layers 3-1 deal with network access. 
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Element Management System with Dynamic Database Updates 
based on Parsed Snooping 

The present application discloses a new approach to maintaining 
concurrency in a network element management database. A back- 
5 ground process constantly monitors the channels which carry network 
element configuration commands, and automatically parses any 
messages which carry information about the status of network elements. 
The information derived from parsing these messages is then used for 
a dynamic update of the database of network element attributes. This 
10 means that the database is completely current on the very latest status 
^ changes, and operators do not have to cross-check log files to see if 

ifi their data is current. Instead, a simple database query retrieves fully 

P current information. 

|fl In one subclass of embodiments the information from a database 

In 15 query is dynamically linked into the operator's interface, so that an 
operator's screen will immediately reflect any relevant database 
updates. 

A particular advantage of this innovation can be seen in systems 
where leased bandwidth is used, or where maintenance is contracted 
20 out, so that it is possible for more than one entity to be working 
simultaneously. 
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Brief Description of the Drawings 

The disclosed inventions will be described with reference to the 

accompanying drawings, which show important sample embodiments 

of the invention and which are incorporated in the specification hereof 
5 by reference, wherein: 

Figure 1 shows NETSMART connectivity to NEs. 

Figure la shows a network management diagram with vendors using 

vendor specific or standard interfaces to communicate with a 

multi-vendor network. 
10 Figure lb shows the typical layer architecture for management of 

telecommunication networks. 

Figure 2 shows NETSMART window layout. 
S Figure 3 shows NETSMART topology with drop-down file menu. 

!J Figure 4 shows the filter dialog, a sample of NETSMART dialog 

h 15 elements. 

iJl Figure 5 shows the topology manager (with NEs created), 

ifl Figure 6 shows the topology search NE dialog. 

jU Figure 7 shows the result of selection using the search NE dialog. 

Figure 8 shows the link report in the topoloigy manager/ 
20 Figure 9 shows OC-192 2F-BLSR. 

Figure 10 shows the configuration of the equipment tab view. 
Figure 11 shows the configuration of the properties view. 
Figure 12 shows the systemadministration view from the administration 
manager window. 

25 Figure 13 shows the address mangement view from the administration 
manager window. 

Figure 14 shows the all-view of the address list. 
Figure 15 shows the NEU management view. 
Figure 16 shows the concept of installing generics from a local 
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machine. 

Figure 17 shows installation of generics from a remote machine. 
Figure 18 show sthe remote memory backup and restore window. 
Figure 19 shows the crossconnects: DSO XC tab. 
5 Figure 20 shows the crossconnects: FASTLANE XC tab. 
Figure 21 shows the crossconnects: SONET XC tab. 
Figure 22 shows the crossconnects: SONET XC tab hairpinning view. 
Figure 23 shows the crossconnects: SONET XC tab. 
Figure 24 shows the crossconnects: crossconnect report. 
10 Figure 25 shows the crossconnects: DSO XC tab. 
Figure 26 shows the managing facilities dialog. 
Figure 27 shows the interface tab: INA attributes view. 
Figure 28 show sthe PM element view (from NETSMART menu): 
in monitors tab. 

!S! 15 Figure 29 shows the performance manager elelemt view— registers tab. 
ifi Figure 30 shows the performance manager element view—database tab. 

[q Figure 31 shows the performance manger equipment view. 

;L, Figure 32 shows the performance manager groups/facilities view, 

ill Figure 33 shows the crossconnect report dialog (by crossconnect type). 

;H 20 Figure 34 shows the architecture components of NETSMART. 
□ Figure 35 shows the NETSMART process architecture. 

Figure 36 shows the a hardware architecture for one embodiment of 

the present application. 

Figure 37 shows the NETSMART server architecture. 
25 Figure 38 shows a meta model class diagram. 

Figure 39 shows a meta base assembly class diagram. 
Figure 40 shows a meta base assembly state transition diagram. 
Figure 41 shows a meta node class diagram. 
Figure 42 shows a meta assembly loading diagram. 
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Detailed Description of the Preferred Embodiment 

The numerous innovative teachings of the present application will 
be described with particular reference to the presently preferred em- 
bodiment (by way of example, and not of limitation). 

5 Overview of NETSMART® 

NETSMART is a true carrier-class network management system 
capable of managing very large Fujitsu-based SONET deployments 
while simultaneously supporting many active users. NETSMART helps 
build a business by providing the tools to monitor, provision, and 
10 troubleshoot the network with unprecedented scalability, graphical 
interface simplicity, and reliability. As with other user-friendly network 
■'.g management software products, the NETSMART system has an easy- 

^ to-use, inmitive graphical user interface (GUI) that allows the user to 

Q display a hierarchical view of the network down to the shelf and card 

^ 15 level. NETSMART will also permit the user to obtain graphical control 
'0 over surveillance, provisioning, software download (SWDL), remote 

□ memory backup (RMBU), and remote memory restore (RMR). This 

l^j feature-rich interface allows the user to perform operational tasks 

in without entering data or TLl commands. Point and click operations 

20 allow the user to accomplish the vast majority of all tasks without 
typing. 

The NETSMART system runs on SUN® Enterprise servers sized 
to meet system requirements. It supports Fujitsu's FLM add/drop 
multiplexers, FACTR® universal transport and access platform (all the 
25 way down to DSO level), FLASH™- 192 lightwave add/drop 
multiplexers, and FLASH WAVE wavelength division multiplexer 
(WDM). 
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NE Supp ort 

NETSMART supports many earlier NE releases. For those NEs 
not directly supported by this version of NETSMART, NETSMART 
also provides backward and forward NE compatibility. 
5 Backward compatibility allows NETSMART to manage an NE as if its 
software were at a higher release level than it actually is. 
Forward compatibility allows NETSMART to manage an NE as if its 

software were at a lower release level than it actually is. 
NETSMART also provides Fujitsu Generic Support (FGS) for unknown 
10 Fujitsu NEs. FGS includes: 

• Login/logoff 

• Receive, store, and display alarms 

• Display of generic NE icon on the Topology Display 
111 • Allow/inhibit alarm reports 

m 15 NETSMART Features 

,n NETSMART combines the functions of both the element 

:L, management and network management layers of the Teleconmiunica- 

m tions Management Network model to provide comprehensive manage- 

ment capabilities to the users of Fujitsu networking products. 

20 General Application Features 

NETSMART provides the following general application features 
as part of a comprehensive and robust element and network manage- 
ment solution: 

• Management of up to 4000 NEs from a single server platform 
25 • Support for OSI DCN connectivity 

• TLl command line and batch file support 

• Generic NE icon capability 
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• Distributed and scalable architecture 
Support for up to 50 simultaneous users 

• Support for IP DCN connectivity 

• TLl console allows users to monitor TLl communication between 

the NETSMART server and one or more managed NEs 

• Intelligent uninterrupted power supply (UPS) support for greatly 

decreased start-up times after power failure and for enhanced 
protection from file system corruption 

Configuration Management 

NETSMART provides the following configuration management 
features to support easy and rapid provisioning and inventory manage- 
ment for both individual NEs and entire transport networks. 

Flexible Topology Management 

• Topological link and physical link views 

• User-defined groups of NEs with the ability to easily move NEs 

between groups 

• Tree-widget view of groups, similar to Windows® Explorer, 

allowing easy viewing and manipulation of managed NEs 

• Tabular view of network information 

Comprehensive Network Element Management 

• NE definition, profiles, and configuration autodiscovery 

• Add user-defined NE or group attributes 

• User-defined NE audit and reconciliation 

- Select autonomous messages to be allowed upon NETSMART 

login 

- Manual or automatic database reconciliation; option to update 
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NE or NETSMART. 
NE shelf display with visual indications of equipment states 

• GUI-based provisioning of attributes and services states for shelves, 

plug-in units, and facilities 
5 • GUI-based cross-connect management, providing comprehensive 
management tools, including redline, DSO, hairpinning, 
FASTLANE™ , and transmux cross-connect management 

- Toolbar shortcuts (1-way, 2-way, 2-way add/drop, 1-way drop 

and continue, 2-way drop and continue) 
10 - Bulk cross-connect operations 

- Ability to assign a name to cross-connects 

• DWDM wavelength management reports 

Network element software management 

• Remote NE software upgrades via OSI DCN 

15 • Remote NE database backup and restoration via OSI DCN 

- Ability to restore database to a different NE for rapid NE turn- 

up 

• Remote NE software upgrades via IP DCN (FLASH- 192 Release 

4.2 and FLM 2400 Release 14.2BS only) 
20 • Remote NE database backup and restoration via IP DCN (FLASH- 
192 Release 4.2 and FLM 2400 Release 14.2BS only) 

Full-Featured Network Inventory Management 

• Network wide inventory of NEs, shown in Figure 5: TID, NE type, 

release level, audit state, DCN type. 
25 • NE level inventory reports: CLEI code, part number, equipment 
service state, date of manufacture, etc. 

• Equipment find function: Network-wide search for CLEI code or 
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part number 
Fault Management 

NETSMART provides the following network surveillance and 
troubleshooting features to allow fast and reliable tracking of network 
5 alarms and to provide network operators with tools to quickly and 
easily isolate network troubles. 

Netw^ork Surveillance 

An alarm banner at the top of the Topology window containing 

summary alarm counts and one-click access to alarm reports 
An active alarm list containing current alarms, standing conditions, 
alarm acknowledgment information, and alarm record annota- 
tions 

An alarm history log showing cleared alarms and cleared standing 
conditions. 

A transient condition log maintaining records of transient condition 

alarms (TCAs) received from managed NEs. 
and transient conditions 
Alarm-sensitive topology map and shelf views 
Audible alarm indications 

Customized alarm viewing options allowing user-defined sorting, 

filtering, column display/placement, and report layout 
One-click navigation from alarm record to Shelf view. 

Network Troubleshooting 

• Protection switch operation and release 
25 • Facility loopback operation and release 

• STS path trace 



10 • 



15 • 



20 • 
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DWDM section trace for the detection and isolation of errors 
between DWDM fiber facilities 

Performance Management 

NETSMART provides the following performance management 
(PM) features to support rapid and accurate detection, isolation, and 
correction of network performance problems: 

• Enabling and disabling performance measurement collection from 

the NETSMART GUI 
© Collection of both equipment- and facility-related measures with a 
15-minute resolution 

• Selection and display of PM information through customized 

NETSMART reports 

• Printing and storage to external files through the NETSMART GUI 

Security Management 

NETSMART provides the following security management 
features, which allow quick and accurate administration of user 
privileges while ensuring robust operation within a secure network 
operations environment. 

• GUI-based functional user profile management allows the customiz- 

ing of roles through the combination of individual application 
features. 

• Conmion user roles, such as server admin, client admin, cross- 

connect user, and alarms user are predefined and available out 
of the box. 

• GUI-based user account management, including the ability to enable 

and disable accounts either on an on-demand or scheduled basis, 
are provided. 
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Comprehensive security reporting, including reports listing defined 
users, users with active sessions, and historical user activity is 
provided. 

Platform Requirements 

The recommended platform configurations for NETSMART 
1.2.2 are: 

The server should be sized (CPU and memory) to meet application 
requirements (number of NEs, number of users) with an even 
number of CPUs and with 2 GB of memory for each pair of 
CPUs. 

The disk size, tape and monitor can vary. 

Detailed Description of NETSMART 

NETSMART is the next-generation network element management 
software application for the Fujitsu FLM, FACTR®, and FLASH® 
product lines. In addition, Fujitsu network elements (NEs) that are not 
fully supported by NETSMART, but conform to a set of basic TLl 
commands, are minimally supported for alarm and configuration 
purposes. The NETSMART client/server configuration supports up to 
25 simultaneous users. Further details can be found in the 
NETSMART 1.2 Installation and Administration Guide (FJTU-320- 
940-150) and NETSMART 1.2 Users Guide (FJTU-320-940-100), both 
of which are hereby incorporated by reference. 

The graphical user interface (GUI) allows: 

• Display and update of network topology 

• Creation of uniquely named NE nodes, groups of NEs, and links 

• Propagation of alarms to network topology icons 

• Management of NE configurations, including cross-connects 
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Monitoring of alarms 

Performance of troubleshooting procedures 

• Execution of remote NE memory backup and software downloads 

• Management of user security 

• Retrieval of performance management reports 

• Wavelength management 

NETSMART is designed to operate on a dedicated Sun® 
server/workstation. The application uses the TLl Operational Support 
System (OSS) language over an Open Systems Interconnect (OSI) 
protocol stack to communicate with remote NEs. Management of NEs 
is accomplished over a combination of wide area networks (WANs), 
local area networks (LANs), and data communications channels 
(DCCs), as shown in the example configuration. Figure 1. 

Network Elennients Supported 

NETSMART software supports Fujitsu NE releases at three 
different levels: 

Full Support: All NETSMART ftinctions are available. 
Forward-Compatible Support: 

• Download forward-compatible release level to the NE 

• Log on and maintain a session with the NE 

• Monitor alarms from the NE (new alarm types may not be recog- 
nized) 

• Display the shelf view of the NE 

• Provision the NE capabilities that were available in the previous 
release 

• Perform remote memory backup and restore (if the NE supports it) 

• Support other features previously supported 
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Backward-Compatible Support: NETSMART treats an earlier release 
of an NE as the immediate later major release and processes 
autonomous messages and command responses as if they were 
from the more recent version of the NE. Commands that cannot 
5 be carried out by the earlier release would be denied, but 

NETSMART would continue to function. 



iJl 



Using NETSMART 

The following section describes: 

• The common desktop environment (CDE); 

10 • How to start the NETSMART™ application on a server and a client; 

• How to log on and off; 

• How to turn off the workstation. 



Common Desktop Environment 

The CDE is a basic component of the Sun UNIX platform and 
15 provides access to start and stop the desktop applications, one of which 
is NETSMART. The CDE toolbar is located at the bottom of the 
m computer screen. The server CDE toolbar has the Heartbeat icon on 

the left that provides access to administration type functions. These 
u functions are covered in the NETSMART Administration and Installa- 

Q 

20 tion Guide. To learn about the various applications available through 
the toolbar, access the Help menu by clicking the books and question 
mark icon next to the trash can icon. Several topics display that explain 
the CDE and its applications. 

NETSMART User Levels 
25 Three levels of NETSMART users are defined: 

System Administrator— is the top-level UNIX operator. The 
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System Administrator is responsible for loading the NETSMART 
software onto the server and other related tasks. 

NETSMART User Administrator— is the top-level NETSMART 
operator. The NETSMART User Administrator has all NETSMART 
5 privileges within the application, including the ability to create other 
NETSMART user accounts. 

NETSMART User— is the operator-level user. The rights of 
these users are defined by a role description, which is classified by the 
NETSMART User Administrator. For example, an Alarms User is 
10 restricted to using only those conmiands related to responding to 
alarms. This user will not be allowed to perform cross-connects. 

Starting the NETSMART Application 

A central station called the server runs the NETSMART server 
application and, optionally, the client user interface(s). After 
15 NETSMART is started on the server, it can be started on the client(s). 
Each client can perform functions independently of the other clients. 
Running NETSMART on a client has the following effects: 

• Only the client initiating the request will receive a response. 

• Autonomous alarms sent from the NE will be received by all 
20 workstations. 

• Depending on the user security level, a user can configure 

NEs; however, only one user at a time can access the 
following functions: log on an NE, log off an NE, add 
NE, delete NE, software download, and NE security. 
25 NETSMART automatically logs on the NEs defined as autologon 

before the user logs on NETSMART. As each NE is logged on, its 

alarm status is downloaded to NETSMART. 
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Exiting the NETSMART Application 

Exiting NETSMART closes the NETSMART user interface 
software program. The network is not affected and the NETSMART 
server will continue to monitor the network. Normally NETSMART 
5 runs continuously on the Sun workstation. However, if it becomes 
necessary to turn off the server, shutdown procedures are included in 
the System Administration and Installation Guide. 

The NETSMART™ user interface allows quick identification of 
and response to alarm conditions in a monitored network. The system 
10 uses windows and a mouse to minimize keyboard use and training 
requirements for users. 

NETSMART Window Layout 

The Topology window (Figure 2) displays after the user has 
logged on the NETSMART application. As additional operations are 

15 started up, additional windows can be opened, including multiple 
occurrences of the same window. Windows can be resized and moved 
to allow multiple views of the network. For example, a shelf that is in 
an alarmed state can be displayed in one window and a listing of 
related alarms can be displayed in another. Figure 2 is an example of 

20 different element positions in the major NETSMART windows. The 
NETSMART window elements are: 

Title bar— The tide in the title bar can reflect the top-level 
element, the component, and the federation being viewed or the type 
of report or operation being performed. For example, the topology map 

25 displays "NETSMART: federation 1: Topology" to reflect the top level 
of network elements, the component, and the federation. If the view 
was switched to the DSO XC tab for an NE in the Configuration 
Manager, the title reflects the NE TID, such as "FLM150J." Log 
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Managers will display the type of log, such as "Activity Log." 

1. Menu bar— The menu bar wording defines categories of 

NETSMART commands. Clicking and holding down the 
cursor on a menu word displays a drop-down list of the 
available commands for that category. Continuing to hold 
down the button, dragging the pointer to highlight the 
desired command, and then releasing the button causes the 
command to start executing. 

2. Toolbar— The toolbar displays the tools, which are command 

buttons that provide quick access to frequently used 
functions. For example, on the Topology window, this 
area is used for NE logon, NE logoff, deleting an NE, 
adding a ring, and adding a chain. On the right-hand side 
of the toolbar are the four alarm condition tools. The 
alarm tools display the number of current alarms and will 
flash if there are alarms that have not been cleared or 
acknowledged. 

3. Tree— In the Topology window, this area displays a hierarchi- 

cal list of NEs and groups of NEs. In the Configuration 
window, this area lists cards or facilities, depending on the 
selection. In the Security window, this area lists users, 
roles, or user sessions. 

4. Graphical area— This area is used to display large graphical 

information such as network maps, shelf views, icons, or 
reports. Dialog and message boxes can also be displayed 
on top of this area. 

5. Icons— An icon is a graphic representation of an object. Icons 

are described in legends that are available on related 
windows and are described in Appendix A of this docu- 
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ment. 

6. Status bar— The status bar is used to display useful informa- 

tion such as the results of the last command or the current 
status of the selected NE. 

7. Scroll bars— Scroll bars can be used to reposition a portion 

of the window when the displayed information exceeds the 
size of the window. Either clicking on an arrow or 
dragging the scroll button will move the display. 

NETSMART Window Elements 

Several types of Windows elements may appear in the NETSMART 
window area when commands are selected. These elements are: 

1. Dialogs— NETSMART uses dialogs to request information 
from the user. After supplying the requested information, click on a 
command button to execute the command. The Tab and SHIFT -I- Tab 
keys move the cursor between entry fields in the box. 

2. Message Boxes— A message box is displayed to explain why 
a command cannot be completed, to inform the user of an action in 
progress, or to remind the user of the possible consequences of a 
choice. 

3. Command buttons— Such as OK, Cancel, Apply, and Help 
(located across the bottom of a dialog or message boxes) initiate an 
immediate action when chosen. 

4. Reports— NETSMART can display data about NEs, 
provisioning parameters, or conditions in a tabular form. Often that 
data can be saved as a file and/or printed. 

Menu Conventions 

Many NETSMART commands are available from the toolbar or 



App'n of Fujitsu Network Communications, Inc.: FN-3014 



Page 24 



from NETSMART menus (Figure 3). There are three types of 
NETSMART menus: 

• Main menu, the horizontal Ust of command names located immedi- 
ately below the window title 

5 • Associated drop-down menus for each main menu selection 

• Pop-up menus, usually displayed from a mouse right-click action 

NETSMART Dialog Elements 

NETSMART dialog elements are the building blocks that are 
used on the base dialog window to add functionality to each dialog. 
10 Different dialogs contain different elements to reflect the particular 
action(s) to be caused by activating the dialog information. 

m Dialog Title 

Most NETSMART dialogs have a dialog title or name displayed 
in the top portion of the dialog border. In some instances, the dialog 
15 title may contain the name of a selected element, rather than a constant 
single title. Other dialogs may have both a constant title and a variable 
name of a selected element. 

Dialog Entities 

A dialog may contain field labels, data/text entry fields, radio 
20 buttons, check boxes, list boxes, drop-down menus, slider bars, and 
conraiand buttons. 

The data/text entry field is designed for the user to type 
information. 

Radio buttons are mutually exclusive groups of buttons. Selecting 
25 one button in the group will deselect all other buttons in the group. 
Check boxes are used to indicate one or more choices. 
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List boxes display a list of values from which the user can select 
a single value or a group of values. Contiguous (adjacent) groups of 
values are selected by holding down the SHIFT key while selecting the 
values with the mouse. Noncontiguous groups of values are selected by 
5 holding down the CONTROL key while selecting the values with the 
mouse. 

Drop-down menus are menus that display when a selection is 
made from a list box (Figure 4). 

Slider bars are used to set levels. For example, the NETSMART 
10 General User Preference dialog uses a slider bar to set the number of 
minutes that NETSMART can be idle before the NETSMART 
application screen locks. 

Command buttons are located at the bottom of dialog boxes. 
They are used to indicate what action NETSMART should take with 
15 the information that the user entered in the dialog. 

NETSMART Message Boxes 

NETSMART message boxes are a form of dialog designed to 
alert the user to an impending condition that may alter the current state 
of NETSMART or NETSMART elements. Message boxes can be one 
20 of three types: 

Acknowledgement— displays a message that must be acknowl- 
edged before continuing. This is usually a "wake-up" type of message 
and is not associated with any potentially system-affecting actions. 
Decision— requires the user to decide how to proceed by 
25 selecting a command button. 

In Progress— Displays a message stating that an event is 
occurring and a moving bar to indicate that the process is still 
continuing. Closing the message box does not stop the process. 
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NETSMART PROCEDURES 

The Topology window displays when NETSMART is started for 
the first time. If no network elements (NEs) have been created, no NEs 
will display in the Topology window on start-up. Figure 5 shows 
5 Topology with NEs already created. 

Note: Most of the main NETSMART™ windows are accessed 
through the different software managers. These managers are 
listed on and accessed through the NETSMART menu. Therefore, 
in the following procedures, the relevant manager is indicated in 
10 the first steps. If the proper manager window is not open, it can 

be opened by selecting the NETSMART menu option and then 
clicking the appropriate manager option. 
A variety of methods can be used to perform these functions; however, 
the 

15 procedures here are written to offer the most direct methods. Referenc- 
es to applicable windows are included in the procedures. As NEs are 
created, they are, by default, autodiscovered and logged on. NEs will 
not be automatically discovered if the user specifically deactivates the 
default Auto Logon field during NE creation. 

20 Some dialogs are available from several different manager 

screens because of their general nature. They allow the user to set 
environmental preferences and lock/unlock the NETSMART screens 
for security purposes. 

Create and Manage NEs 

25 This section describes how NEs are added, modified, maintained 

and deleted in the NETSMART database. Only Fujitsu NEs are 
supported in this release and they must have already been physically 
configured in the network using either TLl commands or the FLEXR® 
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interface. Fujitsu NEs that are not currently in the supported list, but 
comply with Telcordia TLl grammar, are supported as generic NEs for 
commands such as ACT-USER, RTRV-ALM-ALL, and INH- 
DBREPT-ALL. 

Find NE or Group 

This procedure helps to locate an NE or a group of NEs. 
Add an NE 

This procedure adds an NE definition to the NETSMART 
database. However, to become active, the NE must already be 
physically in the network and configured using either the FLEXR 
interface or TLl commands. 

Clone an NE 

Use the Clone NE dialog to make a copy of an existing NE 
definition. Make changes to the clone to identify a new NE in the 
network. 

Edit NE Parameters 

Editing an NE allows changes to be made to some basic NE 
parameters in the NETSMART database. 

Note: The contents of the User ID and Password fields cannot be 
changed for an active NE. If these are to be changed, the NE 
must be logged off and deleted and added once again with the 
new User ID and Password information. 

Delete an NE 

Note: NEs should not be deleted during logon (the NE icon 
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background is white). Wait until the server has finished logging 
on, then proceed with the delete operation. Deleting an NE 
during logon could cause the NE to be deleted partially. If the 
NE is partially deleted, you need to restart NETSMART to 
5 resolve the problem. 

Deleting an NE logs the user off the NE and removes it from the 
NETSMART database. Deleting an NE also deletes any links associat- 
ed with the NE. The NE is still physically in the network, but is 
removed from the NETSMART database. 

10 Log On an NE 

The user must log on an NE to perform configuration changes 
and receive alarm information. Only NEs that are in an inactive state 
can be logged on. If this is the first time this NE has been logged on, 
autodiscovery is invoked (NETSMART communicates with the NE 
15 database and loads the configuration information into the NETSMART 
database). If you select Auto Logon in the Add NE dialog, the log-on 
process will start as soon as you click Ok or Apply in the Add NE 
dialog. 

Log Off an NE 

20 Logging off an NE ends communications between NETSMART 

and this NE, but the NE is still defined in the NETSMART database 
and is functioning in the network. 

Audit an P^E 

Auditing an NE compares the information contained in the 
25 NETSMART database with the information stored in the NE. The 
results of the audit are displayed. When you audit an NE using the 
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following procedure, the Audit/Reconcile level that you set will apply 
only to this audit. The Audit level that you set when you created or 
edited an NE will apply only when the NE is restarted. 

View the NE State 

The current state of any NE in the network can be viewed. 
Resynchronize an NE 

Database resynchronization ensures consistency between the NE 
database and the NETSMART database. Resynchronization involves 
retrieving the entire database or distinct portions of that database from 
the NE and comparing this information with that contained in the 
NETSMART database. Either the NE database or the NETSMART 
database may be the master data source, depending on the type of data. 

Resynchronization can be a time and resource intensive process. 

Managing Groups of NEs 

Groups are used to organize NEs and partition the network. A 
group icon can represent one or more NEs or groups of NEs. The 
background color of the group icon reflects a highest unacknowledged 
alarm level of NEs in tlje group. 

Find a Group of NEs 

Finding a single NE and a group of NEs is accomplished using 
the same dialog. 

Add a Group Definition 

A group definition can be created and then a group of NEs can 
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be defined or moved into the new group. 
Edit Group Parameters 

Editing a group allows the user to change group parameters. The 
group parent can also be changed either by dragging the group icon 
under a new parent in the tree area or by typing a new parent name in 
the Parent Group field on the Edit Group dialog. 

Delete a Group Definition 

Note: Deleting a parent group results in deletion of all groups 
under the parent group. 

This selection deletes a group definition fi^om the NETSMART 
database. If the group has NEs assigned, a warning is displayed and 
must be acknowledged before the delete is completed. The group icon 
will be removed from the topology map and tree structure. 

Use a Different Baclcground Map for Each NE Group 

A different background map can be established for each group 
of NEs so that when the group is selected, the NEs will be displayed 
on an appropriate map. The map file(s) must be in "jpg" format and 
must be accessible by the server. The file can be on a server drive, on 
a CD ROM or on a floppy disk that has been placed in the floppy disk 
drive (use the UNIX volcheck command to recognize the floppy disk). 

Search NE Dialog 

The Search NE dialog displays whenever the related Search 
button is selected in another dialog that requires an NE name be 
provided (for example, in the Add Link dialog). The following 
procedure assumes that you are currently working in a dialog with a 
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Search button. Figure 6 shows the Topology Search NE Dialog. 



Search Group Dialog 

The Search Group dialog displays whenever you click on the 
related Search button in another dialog that requires a group name be 
5 provided (for example, in the Add NE dialog). The following proce- 
dure assumes that you are currently working in a dialog with a Search 
button. 

Connect NEs (Links, Chains, Rings) 

Network Elements (NEs) are connected to provide various 
10 telecommunications services. Connection procedures add information 
about the different types of connections to the NETSMART database. 
They do not affect the NEs and physical network because the work 
defined in these procedures must be completed by on-site field 
technicians. 

15 Within NETSMART, a single connection between two NEs is 

referred to as a physical link. The display of this information on the 
topology map is referred to as a logical link. There may be more than 
one physical link between two NEs, but it will be displayed as a single 
line on the topology map unless the connections form a ring. If a ring 

20 is formed using only two NEs, both links are displayed as angled lines, 
showing as a diamond pattern. 

In NETSMART, a link in one direction only is a unidirectional 
link. A link in both directions is a bidirectional link. 

In NETSMART, a connection is fully protected only if there are 

25 two separate routes and these routes do not share any link. A connec- 
tion is partially protected if there are two separate routes but these 
routes do share a link. 
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Add a Link 

A link represents a physical connection between two NEs, 
including generic NEs. This procedure adds the link information to the 
NETSMART database to represent the connections in the network. It 
does not affect the networks. 

Note: The selected group and NE will determine the contents of 

the fields on the Add Link dialog. 

Tasks: 

1 From the NETSMART Topology window, log on all NEs to be 

included in the link. 

2 Select Add Link from the Edit menu or select the Link tool from the 
toolbar. 

3 Using the Search button, select information in the following fields: 

Group 1— Use this field along with the Search button to select 
a parent group. 

NEl— Use this field along with the Search button to select an 
NE. After the NE has been selected, available ports are 
displayed in the Linkable Termination Ports section of this 
dialog. 

Group 2— Use this field along with the Search button to select 
a parent group. 

NE 2— Use this field along with the Search button to select an 
NE. After the NE has been selected, available ports are 
displayed in the Linkable Termination Ports section of this 
dialog. 

Linkable Termination, Ports— This field displays a graphic 
representation of the ports that are available for connection 
for both selected NEs. If a connection is already in use, 
the box is grayed out. If a link needs to be created to a 
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generic NE, the facility (for example, HSl-1, 1-P) port 
must be typed into the text field at the top of the Linkable 
Termination Ports area, followed by a carriage return. 

Under each text field, a set of boxes is displayed. 
Each box displays the RATE (for example 0C3), AID (for 
example IP) and two direction buttons: Tx (Transmit) and 
Rx (Receive). Direction buttons are used to make the 
connection. These buttons also indicate if a port is unidi- 
rectional or bidirectional. If both Tx and Rx are enabled, 
the port is bidirectional. If either Tx or Rx is grayed out, 
the port is unidirectional. 

4 Make a connection between the NEs using one of the following 

methods: 

• To create a unidirectional link from Tx to Rx, click on the Tx button 

for a linkable port for the first NE to select it. Then move the 
mouse to the linkable port for the other NE and click on the Rx: 
button if it is not grayed out. A line displays showing the link, 
and the Tx and Rx buttons for those ports will be grayed out. 

• To create a unidirectional link from Rx to Tx, click on the Ex button 

for a linkable port for the first NE to select it. Then move the 
mouse to the linkable port for the other NE and click on the Tx 
button. A line displays showing the link, and the Tx and Rx 
buttons for those ports will be grayed out. 

• To create two unidirectional links for a bidirectional port at the same 

time, click in an area in the box outside the Tx or Rx buttons for 
a bidirectional port for the first NE. Then move the mouse to a 
bidirectional port for the other NE and click in an area in the 
box outside the Tx or Rx buttons. A line displays showing the 
link, and the Tx and Rx buttons for those ports will be grayed 
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out. 

Once a link is successfully created, connection lines will indicate link 
direction(s), as shown in Figure 7. Additional links can be added until 
all connections have been defined. 

Note: To deselect a box or button^ click on it. 

5 If the last connection needs to be removed (and Apply or Ok has not 

been selected), click Undo. If all connections need to be 
removed, click on Clear AIL 

6 Click Apply to add this link information and leave the Add Link 

window displayed. Click Ok to add the link information and 
close the Add Link dialog. 

7 From the View menu, select Graphical to return to the Topology map 

display. The link displays on the topology map. 

Display Link Information 

A link represents a physical connection between two NEs. This 
is NETSMART database information and may not reflect actual 
physical network connections. To display the link information for a 
single link, double-click on the link or right-click and select Link 
Report from the menu. 

To display the link information for all the links, from the 
NETSMART Topology window, select Links Report from the View 
menu. The tabular view of the Links report (Figure 8) displays. 

Note the new features of the Link reports in this release: 

• An EditName tool can be used to change a physical link name. 

• Multiple selection of rows can be used with the Delete and EditName 

operations. 

To select a row on the Link Report, click on the row header (numbered 
from 1 up to the number of physical links displayed) and the row will 
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become highlighted. 

For multiple selections, two options are available: 

• Hold down the SHIFT key and click on the desired rows to select a 

contiguous set of records. 

• Hold down the CTRL key and click on the desired rows to select a 

non contiguous set of records. 
To view the Display Link dialog for the two NEs in the selected 
physical link, double-click on a row. 

The Link Report toolbar offers the following functions: 
Print Print up to 100 lines of the current information. Refer to Printing 

Overview for more information. 
Filter Display a dialog where you can specify criteria to filter the 

information in the display. Refer to Filtering Tabular Information 

for more information. 
Sort Display a dialog where you can specify criteria to sort the 

information in the display. Refer to Sorting Information. 
Columns Display a dialog where you can specify information to be 

shown or hidden. Refer to Setting Column Displays for more 

information. 
Deselect Deselect any selected rows. 

Reload Update the display with information from the database. 

Delete Delete selected physical links from the database. 

EditName Change the name for selected physical links. Use the Edit 

Name dialog to type a new link name. Click on Ok to confirm 

the change(s). 

Edit a Link Name 

The link name defaults to the format < TID > : < port > : < Tx or 
Rx>::<TID>:<port>:<Tx or Rx> of the connection (for 
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example, FLASH-G:HS1-1: Tx::FLASH-F:HSl-2:Rx). This link name 
can be changed to reflect user preference. 

Delete a Link 

A link can consist of a number of connections between two NEs. 
This procedure describes how to select an individual connection within 
a link before deleting the information from the NETSMART database. 
The procedure does not affect the actual physical connections, so links 
are referred to as "topology links." 

Add a Chain 

Chains use high-speed links to connect terminal and linear NEs. 
This procedure describes adding the link information to the 
NETSMART database. The actual physical connections are not 
performed using this procedure. All NEs that will be included in the 
chain must be logged on. Generic NEs cannot be included in a chain 
because the NE type cannot be accurately determined. An NE at the 
end of a chain must be configured as a terminal type of NE. 

The Add Chain function is a "best-effort" operation. If two or 
more of the NEs specified in the list of TIDs encounter a compatibility 
error during ring creation, a dialog box will display. This dialog 
reports which links were created successfully and which links encoun- 
tered errors. The chain will be displayed as lines between NEs. To 
access the Add Chain dialog, first display the Topology window, and 
ensure that all NEs targeted for the chain have been autodiscovered. 

When the dialog closes, the chain displays on the Topology map. 
The corresponding links are added to the NETSMART database. Those 
links that were created will be displayed on the Topology map. For 
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those links that generated errors, one or more of the following self- 
explanatory error messages may display: 

• The configurations for the specified NEs are not compatible. 

• High-speed links already exist between two or more of the specified 

NEs. 

• High-speed rates are not compatible for two or more of the specified 

NEs. 

• The directions of the high-speed ports are not compatible for two or 

more of the specified NEs. 

• The payloads of the high-speed ports are not compatible for two or 

more of the specified NEs. 

• The port sequences of the high-speed ports are not compatible for 

two or more of the specified NEs. 

Add a Ring 

A ring provides alternative routing in case of a single failure 
within a network. This procedure adds a ring definition to the 
NETSMART database. The actual physical connections are not 
performed using this procedure. 

The Add Ring function is a "best-effort" operation. If two or 
more of the NEs specified in the list of TIDs encounter a compatibility 
error during ring creation, a dialog box will display, reporting which 
links were created successfully and which links encountered errors. 
Those links that were created will be displayed on the Topology map. 
For those links that generated the errors, one or more of the following 
self-explanatory error messages may display: 

• The configurations for the specified NEs are not compatible. 

• High-speed links already exist between two or more of the specified 

NEs. 



App'n of Fujitsu Network Communications, Inc.: FN-3014 



Page 38 



• High-speed rates are not compatible for two or more of the specified 

NEs. 

• Directions of the high-speed ports are not compatible for two or 

more of the specified NEs. 

• Payloads of the high-speed ports are not compatible for two or more 

of the specified NEs. 

• Port sequences of the high-speed ports are not compatible for two or 

more of the specified NEs. 

Build a BLSR 

A bidirectional line switched ring provides alternative routing in 
case of a single network failure as shown in Figure 9, OC-192 2F- 
BLSR. The BLSR provides ring protection switching by detecting OC- 
192 line-level failures. Ring protection involves bridging (transmitting 
identical traffic on both the working and protection channels) and 
switching (selecting traffic from the protection channel instead of the 
working channel). In a bridge and switch, the 96 working time slots (1 
through 96) are bridged onto the 96 protection time slots (97 through 
192) and transmitted away from the failure. 

Each 2F-BLSR can contain up to 16 nodes, labeled uniquely 0 
through 15 in the ring. The ring topology table contains the order of 
the nodes in the ring. 

Squelching prevents traffic miscoimections during node failure 
by inserting STS-1 path AIS at the switching nodes into the time slots. 
Each node on the ring has the identities of the entry and exit nodes for 
all services passing through the node. The squelch table keeps track of 
these entry and exit points by time slot. 

Only the channels that are added or dropped at the isolated nodes 
or used for extra traffic need to be squelched. The squelch table has an 
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entry for each STS-1 time slot that the node is terminating or passing 
through and the source and destination node IDs. 

Note: The squelch table may take some time to display because 

the information is retrieved from the NE. 

Add a Node to a BLSR 

Nodes may occasionally need to be added to a BLSR. This 
procedure adds a node to an existing BLSR definition in the 
NETSMART database. 

Delete a Node from a BLSR 

Nodes may occasionally need to be deleted from a BLSR. This 
procedure deletes a node from an existing BLSR definition in the 
NETSMART database. 

Set/Release Loopbacks 

A loopback tests the transmit and receive capabilities of the 
facilities at both remote and local terminals. A loopback test causes the 
transmitted signal to be returned to the sending device after passing 
through all or a portion of a data communications link or NE. 

Loopback testing is not available on all NE components. An NE 
component is a facility, equipment and/or termination point. If the NE 
component is available, right-click on the NE component in the tree 
area to display a menu containing Loopback. 

The NE must be placed in a maintenance state before a loopback 
can be performed. Placing an NE in maintenance state is not service 
affecting. However, once an NE has been placed in a maintenance 
state, actions performed on that NE may be service affecting (a 
loopback, for instance, is service affecting). 
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Set and Get a Path Trace 

Path trace is a signal sent on the SONET overhead and is only 
supported at the EML layer. It allows the user to assign a unique path 
trace message to the transmit NE and the destination NE. 
5 Tracing a path involves assigning the outgoing trace message 

(TRC) at the transmit NE, assigning the same message for the 
incoming trace message (EXPTRC) at the path destination NE, and 
viewing results in the incoming trace (INCTRC). If the message is 
received correctly, the path trace is successful. 
10 Note: Path tracing is not available on all NE components. 

Set and Get a Section Trace 

In SONET, the terms section, line and path refer to the subsec- 
tions of a route that a signal takes when traveling from origin to 
destination, 

15 A section is the segment of fiber between two repeater NEs. It 

is possible for a signal to be corrupted or degraded over the span of a 
section. To troubleshoot a particular section for signal quality prob- 
lems, a test signal can be sent on the section and the returned signal is 
compared to an expected trace. This is the essence of section trace. 

20 Use the Section Trace window to view and modify the attributes 

related to section trace on a selected facility on an NE. 
Note: Section trace is not available on all NEs. 

Protection Switching 

Protection switching allows a transfer of service between 
25 working and protection facilities or equipment. Protection switching 
allows plug-ins to be removed and replaced without affecting traffic. 
This feature also allows editing of the FFP attributes of facilities and 
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equipment within the optical facility and equipment protection groups. 
Note: Protection switching is not available on all facilities and 
equipment. 

Synchronize Timing 

Timing attributes that will define the synchronization timing 
source for the NE and the facility over which the output clock signal 
is sent, can be set by the user. The synchronization reference can also 
be switched to another source. Choices of primary, secondary or 
internal clock references are available to an NE. 

Note: It is dangerous to set the NE timing reference to internal 

clock timing reference. NEs using internal clock reference can 

easily become out-of-sync with other NEs. 

Note: Synchronization switching is not available on all NEs. 

Equipment Maintenance 

NETSMART can be used to perform basic maintenance on the 
NE hardware. These include: 
^ Adding and deleting a shelf for an existing NE 
^ Provisioning a plug-in unit 
Modifying equipment parameters 

Creating and deleting equipment protection groups (EPGs) 
Add a Shelf to an Existing NE 

The shelf should be installed on an NE before adding it to 
NETSMART. A NETSMART user can add or remove shelves from 
an existing NE. For instance, to add a new Narrowband shelf (NBS) 
to an existing FACTR NE, NETSMART will need to autodiscover the 
shelf and its components such as slots, cards, facilities and cross 
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connects. 

Delete a Shelf from an Existing NE 

A NETSMART user can remove shelves from an existing NE. 
Note: All crossconnects must be removed before a shelf can be 
deleted. 

Provision a Plug-In Unit (Put In Service) 

A main shelf for a FLASH-192 (Release 2.1) or a FACTR 
Common shelf (CMS) or NBS can have some plug-in slots provisioned. 
The shelf must already be installed, but the plug-in does not need to be 
installed. Provisioning can also be accomplished by selecting the card 
or port and changing the required attribute to In Service (IS). Figure 
10 shows the Equipment Tab View for Provisioning. 

Modify Equipment (Card and Port Attributes) 

Individual cards and ports have attributes that can be modified. 
These attributes are shown in blue on the Properties window for the 
card or port. Values that are displayed in red are critical. Changing a 
critical value will trigger an automatic resynchronization. 
Tasks 

1 Log on the NE to be provisioned. 

2 From the Configuration Manager window, select the Equipment tab. 

3 Open the tree. From the tree area, select the card or port to be 

modified. The view in the window changes to the Properties 
view. Otherwise, select the card in the graphical shelf view, then 
right-click to display a menu where you can select Display 
Properties. The Properties view (Figure 11) displays. 

4 Modifiable attributes are shown in red and blue. Black text cannot be 
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changed. In the Value column, click on the selection to be 
changed. A button appears to the right of the text. Type or select 
an option. Click on the button to display a drop-down list of 
available options. Select an option from the list. Repeat this step 
5 for all attributes that need to be changed for this card or port. 

5 Click on the Modify tool, or select the Update option from the 
Operations menu. The Modify Attributes Operation progress 
dialog displays. When it closes, the attributes have been 
changed. 

10 Create or Delete an EPG 

Redundant equipment provides a level of protection against 
failure of certain plug-in units. For some types of NEs like FLASH- 
192s, EPGs can be activated or deactivated using this procedure. For 
FLM and similar NEs, EPG are automatically created and cannot be 
15 deleted or modified. 



Using the Administration Manager 

The Administration Manager provides the ability to: 
# View administrative details about a selected NE. 
^ Manage NE addressing. 
20 ^ View information about NE use. 

Select Administration Manager from the NETSMART menu to 
display 

administration management tabs. 

Use the System Administration Tab 

25 The System Administration tab displays details about the different 

NETSMART processes that are running on the server. The 
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NETSMART version that is currently installed and the most recent start 
time are shown in the heading. 

Process monitoring can be enabled or disabled. 
System monitoring checks the status of the servers (active or 
5 inactive) You would disable monitoring only in extreme cases such as 
an urgent need for resources. If monitoring is enabled (the default 
setting) and a server goes down, NETSMART will detect state, and 
issues a message and attempts to restart the server. If monitoring is 
disabled and a server goes down, NETSMART will not detect its state 
10 change and will not issue a message or attempt to restart the server. 
Figure 12 shows the Administration Managerview. 

Administration Manager Set Password Dialog 

III From the System menu, select the FTP submenu. There are two 

cascading selections. Set Password, and Show Password. Select Set 



m 



in 15 Password to change the password for security protection during an FTP 
S transmission. 



d 

Hi! 

m 



Use the Address Management Tab 

The Address Management tab provides details about each NE. 
Information includes the TID, the communications protocol, the 
20 originating address type and the address. 

All system-resolved or manually created OSI addresses are 
defined as TARP (Target ID Address Resolution Protocol). All IP 
addresses are defined as NETSMART. When the server restarts, all 
NETSMART addresses are retained; all TARP addresses are lost and 
25 must be re-resolved as part of the login process. 

From the NETSMART System Administration window, select 
the Address 
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Management tab (Figure 13). 
Add an OSI Address 

Every NE in a NETSMART network configuration must have an 
OSI or an IP address. To enable communications within a ring 
5 configuration, the gateway NE must be configured as an IP NE. 

If the NE is not a gateway NE, set an OSI address using the 
following procedure to configure an OSI NE: 

View an OSI Address 

Use this procedure to view an existing OSI address. 
Add an IP Address 

Every NE in a NETSMART network configuration must have an 
OSI or an IP address. When enabling communications within a ring 
configuration, the gateway NE must be configured as an OSI NE. If 
the NE is not a gateway NE, set an IP address for the NE. Figure 14 
shows the Administration Address List— All View. 

View an IP Address 

Use this procedure to view an existing IP address. 
Delete an IP Address 

Use this procedure to delete an existing IP address. 

20 Use the NEU Management Tab 

The NETSMART hardware platform being used will support a 
maximum number of NE units (NEUs). When this number is exceeded, 
the database may not function properly. The NEU Management tab 
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provides information about this usage, allowing for monitoring and 
managing network capacity. 

The NETSMART NE Utilization window (Figure 15) is divided 
into three areas: 

^- The top part of the window contains the window title. The Max 
Capacity field shows the maximum capacity of the network. The 
Current Utilization field shows the current NEU count for the 
network. The Available Capacity field shows how many more 
NEUs can be supported within this network. 

;f The Summary portion of the window shows summary information, 
including the Total Number Of NEs, the number Managed, the 
number Logged-in, the number Logged-out and the number Not 
Managed. 

The total number of NEs is the total count of NEs in the system. 
This includes NEs that are both managed and not man- 
aged. Managed NEs are those that the NETSMART 
system is aware of and has management control over. 
Logged-in are NEs that are logged in and active in 
NETSMART. Logged-out are NEs that are logged out and 
inactive. Not Managed are NEs that NETSMART is aware 
of but does not manage or control. 
^ The Details portion of the window provides detail information, 
including the NE Type, the NE Weight, Number of NEs of this 
type in this network and the NEU Count. The capacity of 
NETSMART systems is based on Network Element Units 
(NEUs). Each type of NE is assigned an NEU value based on 
the number of objects to be managed. 

Use the NEU Management view to monitor the number of NEUs 
currently logged on the system. Once the maximum capacity is 
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reached, the system will deny creation of any new NEs. 

Manage NE Software 

This section provides procedures describing: 

* How to download software generics to an NE 
5 How to perform NE memory backups 

^ How to restore Service Database files to the NE 

* How to activate the software generics 

NETSMART uses an intermediate database called Software Repository 
to store and retrieve generic and service database files. This section 
10 describes procedures you will perform to install and extract software 
generic and service database files using the Software Repository. 

About the Software Repository 

The Software Repository is an internal database that 
NETSMART maintains in order to store software generic and service 
15 database files. It provides a way to extract files from the database to 
the file system. It also provides the means to remove generic and 
service database files from the database. 

The Software Repository works off-line with the NE, so it is not 
necessary to log on to the NE to use this component. Once the generic 
20 or service database is installed in the repository, it can be downloaded 
to the NE using the Software Download (SWDL) component. 

About Remote Memory Backup and Restore (RMBU) 

Remote Memory Backup and Restore (RMBU) is used to make 
an NE memory backup and to restore the backup to the NE, when 
25 required. To use the SWDL and RMBU components, you must log on 
the NE. See Section Remote Memory Backup and Remote Memory 
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Restore for details about using these features. 

An RMBU Scheduler feature lets you schedule RMBU in 
advance. Scheduling options include weekly, monthly or one-time 
backups. See the Installation and Administration Guide, Scheduling 
5 Remote Memory Backups for NEs for details about using this feature. 

Install Generics 

Generics are software files that are specific to a particular NE 
and version. To upgrade the NE to a different version, the new version 
of the generics must be downloaded to the NE. Generics are supplied 
10 by Fujitsu Network Communications, Inc. (PNC) and are available to 
the customer: 
^ On a floppy diskette 
i On a CD ROM 

^ From a local or remote machine, using FTP file transfer 
15 See the Installation and Administration Guide, Installing NE Software 
Generics for procedures on installing software generics from a CD 
ROM or floppy. 

Install Generics from a Local Machine 

Installing generics from a local machine is a single-step process 
20 because generics were already copied into the NETSMART client 
machine file system. Whether the installation is done using FTP, 
floppy disk or CD ROM, the NETSMART server copies the generic 
files into the repository. Figure 16 illustrates the concept. 

Install Generics from a Remote Machine 

25 Installing generics from a remote machine is a single-step 

process. Generics can be directly picked up from the remote machine. 
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In the following information, generics are available on a remote 
machine (where the NETSMART client is not running) that is 
connected to the network. Figure 17 illustrates the concept of installing 
generics from a remote machine. The following are required before 
installing generics from the Client machine: 

The remote machine must be running with the FTP Server daemon 
active. 

^ You need log on access to the machine. 

^ You need to know the directory path on the remote machine where 
the generics reside. 

Extract Generics 

If software generics are installed in the software repository, they 
can be extracted. The local file system can be extracted (where the 
NETSMART client is running) to any other remote machine where you 
have log on access, or can be copied onto a floppy disk or CD ROM 
for distribution purposes. 

Remove Generics 

If software generics are installed in the software repository, they 
can be removed. Be sure to remove the generics from the server 
machine. 

Install the Service Database 

You can install the service database files in the software 
repository for downloading to the NE in extreme cases such as NE 
memory corruption. To install the service database files, you need to 
have a valid set of database files from a previous NE backup created 
with the RMBU manager. Typically, if a memory backup of the NE 
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has been taken, its service database files are stored in the software 
repository. It is possible that these files were extracted to the file 
system. In this case, install the files into the repository to download 
them to the NE. 



5 Install from a Remote Machine 

If the service database files are available on a remote machine 
file system, they can be installed directly into the software repository. 
The following are required before installing generics from the 
NETSMART client machine: 
10 if The remote machine must be running with the FTP Server daemon 

active. 

^ You need log-on access to the machine. 

s You need to know the directory path on the remote machine where 
the generics reside. 

15 Extract the Service Database 

If the service database files are installed in the software 
repository, they can be extracted so that they can be saved on the file 
system or copied onto a floppy disk or CD ROM for distribution 
purposes. Extract the files to the local file system (where the 
20 NETSMART client is running) or to any other remote machine where 
you have log-on access. 

Remove the Service Database 

If the service database is already installed in the software 
repository on the server machine, it can be removed. Be sure to 
25 remove the service database, as others (those using NETSMART 
servers) may want to use the machine. 
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Software Download 

SWDL is used to download new generic software releases 
(software generics) onto an NE using File Transfer Access and 
Management (FT AM) and FTP. As a precondition for SWDL, the 
generic should be installed in the Software Repository. For details 
about installing the generic on the Software Repository, refer to Install 
Generics for more details. 

During the Software Download process, files are copied to the 
RAM Disk on the NE in the first step and then onto the CPUs. There 
are three different categories of NEs. 
: OSI NEs 

IP gateway NE 
«^ IP subtending NEs. 

Software Download on an OSI NE 

The SWDL to Open Systems Interconnect (OSI) NEs is 
accomplished in the following way. 

® The files are copied to the RAM Disk on the NE and then the files 
are copied to the standby memory of the NE, or 

^ Files are copied from Network Management System (NMS) to the 
RAM Disk on the OSI NE using FT AM (for IP gateway NEs 
this is done using FTP). At this stage, the software download is 
in a pending state; it will become active when the software is 
activated. For activation information, refer to "Configuring 
Scheduled Remote Memory Backups". 

Software Download on IP Gateway NE 

SWDL on an IP gateway NE is accomplished in the same way 
as the OSI NE. 
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Software Download on IP Subtending NE 

For subtending NEs, an IP gateway NE is used as a pass-through 
for the files to be copied from the NMS to the destination NE. The 
procedure is accomplished in three steps. 
5 1. The files are copied from NMS to the IP gateway NE RAM Disk. 

2. Then files are copied from the gateway NE RAM Disk onto the IP 

subtending NE RAM Disk. 

3. Finally, files are copied from the subtending NE RAM Disk to the 

corresponding CPUs on the IP subtending NE. 

10 Consecutive Operations 

From a user perspective, software download can be initiated only 
on a single NE at a time. Initiating software download on several NEs 
iH at the same time is not supported; however, you can start software 

download on different NEs, running one after another. Software 
15 download cannot be initiated on any NE while the NE is performing a 
Jp remote backup or a restore. 

JL^ For IP subtending NEs, an IP gateway NE is used as a pass- 

\n through for copying the files. An IP Gateway NE can be a gateway for 

[J several NEs, meaning that all the NEs under this gateway NE are 

13 20 dependent on this gateway NE for software management operations. 

Details Dialog 

Once an NE is selected from the Software Download dialog and 
the download is started, you can monitor the download. Select the 
Details dialog by clicking the Details button in the Software Download 
25 dialog. 

The Details dialog displays the number of files to be transferred 
in each step and also the number of files currently transferring. Status 
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strings on the Details dialog help you to understand the operation. 

An important string called Failure Reason is displayed on the 
Details window if the SWDL is aborted. The failure reason will help 
you to understand why the SWDL failed. 

Abort Operation 

After SWDL is started, the Software Download can be aborted. 
Select the Abort button to display a status string on the SWDL window, 
indicating that the abort has initiated. It may take several minutes for 
the abort operation to be completed, depending on the stage of the 
SWDL. 

Once the abort is completed, the status string contents will 
change to inform the user that the abort has completed. The message 
will provide the time of the abort. You can now schedule an activation 
and set the validation time. For more details about activation, refer to 
"Configuring Scheduled Remote Memory Backups". 

Remote Memory Backup 

Remote memory backup (RMBU) backs up the configuration 
database on an NE to the NETSMART database. At any time, only the 
last two versions of backup (per NE) are stored in the database. The 
backed-up NE configuration information can either be extracted onto 
any machine (with an active FTP daemon) or can be restored from the 
NE database. Refer to Extract the Service Database for details about 
extracting backed-up files onto a remote machine. Refer to Remote 
Memory Restore for details about restoring the NE database. 

During the backup process, files are copied from CPUs to NE 
RAM Disk. There are three different categories of NEs. 
# OSI NEs 
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IP gateway NE 
5 IP subtending NEs 

Remote Memory Backups from an OSI N£ 

A remote memory backup from an OSI NE is accomplished in 
5 the following way: 

i5 The configuration files are copied to the RAM disk on the NE from 
active memory. 

« The files are copied from the NE's RAM disk to NETSMART using 
the OSI FT AM protocol. 

Remote Memory Backup from an IP Gateway NE 

A remote memory backup from an IP gateway NE is accom- 
plished in the following way: 

The configuration files are copied to the RAM disk on the NE from 
active memory. 

^ The files are copied from the NE's RAM disk to NETSMART using 
the FTP protocol. 

Remote Memory Backup from an IP Subtending NE 

A remote memory backup from an IP subtending NE is 
accomplished in the following way: 

« The configuration files are copied to the RAM disk on the NE from 
active memory. 

« Using the OSI FT AM protocol, the configuration files are copied 
from the subtending NE's RAM disk to its gateway NE's RAM 
disk. 

# The configuration files are then copied to NETSMART using the 
FTP protocol. 
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Concurrent Operations 

Backup can be initiated on up to 100 NEs. These NEs include 
OSI NEs, gateway NEs and IP subtending NEs. If backup is initiated 
on an IP subtending NE, this operation locks its gateway NE and 
transfers files through the gateway NE. If backup is initiated on 
multiple NEs within a ring, the gateway NE is shared across these 
backup operations. 

At any time, backup for 10 NEs can be initiated in parallel. If 
backup for more than 10 NEs is requested, backups are serialized. 

During either of the SWDL/RMR (Remote Memory Restore) 
operations on a gateway or subtending NE, you cannot initiate a 
backup on any of the NEs in that ring. If the NE database is being 
restored onto a gateway NE or a subtending NE, a backup cannot be 
initiated on any of the NEs in that ring. 

Details Dialog 

The Details dialog displays the number of files to be transferred 
in each step and also the number of files currently transferring. Status 
strings on the Details dialog help you to understand the operation. 

An important string called Failure Reason is displayed on the 
Details window if the SWDL is aborted. The failure reason will help 
you to understand why the SWDL failed. 

Abort Operation 

You can select an NE and click the AbortBkp tool. Status 
messages for this NE indicate initiation and completion of the abort 
operation. Figure 18 shows the Remote Memory Backup and Restore 
Window. 
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Remote Memory Restore 

If database corruption occurs on an NE, remote memory restore 
allows a previously stored configuration database for that NE to be 
used. The configuration files for an NE are stored either from the 
backup operation or by installing NE database files from a remote 
machine (with the FTP daemon running). Refer to Remote Memory 
Backup for details about backing up NE configuration files from an 
NE. Refer to Remote Memory Restore for details about installing 
these files. 

Log on the NE to be restored. During the restore process, files 
are copied from NMS to NE RAM Disk and then onto CPUs. There 
are three different categories of NEs. 
» OSI NEs 
^ IP gateway NE 
« IP subtending NEs 

Remote Memory Restore to an OSI NE 

A remote memory restore to an OSI NE is accomplished in the 
following way: 

» The configuration files are copied from NETSMART to the NE's 
RAM disk. 

« The configuration files are copied from the RAM disk on the NE to 
standby memory. 

« An activation of the standby memory needs to performed. Refer to 
Software Activation for information on software activation. 

Remote Memory Restore to an IP Gateway NE 

A remote memory restore to an IP Gateway NE is accomplished 
in the following way: 
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* The configuration files are copied from NETSMART to the NE's 

RAM disk using the FTP protocol. 
« The configuration files are copied from the RAM disk on the NE to 
standby memory. 

5 ^ An activation of the standby memory needs to performed. Refer to 
Software Activation for more information on software activation. 

Remote Memory Restore to an IP Subtending N£ 

A remote memory restore to an IP subtending NE is accom- 
plished in the following way: 
10 ^ The configuration files are copied from NETSMART to the gateway 
NE's RAM. 

y ^ The configuration files are copied from the RAM disk on the 

Ipi gateway NE to the RAM disk on the subtending NE using the 

I OSI FTAM protocol. 

IjI 15 § The configuration files are copied from the RAM disk on the 

u 

subtending NE to standby memory. 
" s An activation of the standby memory on the subtending NE needs to 

jjj performed. Refer to Software Activation for more information 

1'^ on software activation. 

o 

20 Consecutive Operations 

A restore can be initiated on only one NE at a time. If any 
software management operation is running on any NE in a ring, you 
cannot initiate a restore operation on any of the NEs in that ring. 
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Backup Details Dialog 

The Details dialog displays the number of files to be transferred 
in each step and also the number of files currently transferring. Status 
strings on the Details dialog help you to understand the restore 
operation. An important string called Failure Reason is displayed on 
the Details window if the restore operation is aborted. The failure 
reason will help you to understand why the restore failed. 

Abort Backup Operation 

While the restore process is active, you can select an NE and 
click on the AbortBkp tool to abort the backup process. Status messages 
for this NE indicate initiation and completion of the abort operation. 

Software Activation 

After the generic or database is loaded into memory, you need 
to schedule an activation. 

Note: When activating either a software download or a remote 
memory restore, activation time can be selected based on the NE 
time. NETSMART reads the time from the TLl response and 
places the NE time plus 2 minutes in the Time field. This is to 
prevent the SWDL or RMR activation time from being the exact 
current time. If this was the case, by the time the user finished 
selecting activation time, the time would now be in the past. 

Managing Crossconnects 

This section provides the procedures for creating NE 
crossconnects. CrossConnect commands perform changes to the network 
and update the NETSMART database. NE crossconnect management 
provides the ability to modify the route for a circuit by changing the 
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NEs and links where a signal is carried. NETSMART's graphical 
crossconnection feature lets you create crossconnects using a mouse 
click interface and lets you view and report on an end-to-end circuit 
through a SONET network. 

Circuits may span multiple NEs and multiple interconnected rings 
and virtual rings. You can select the appropriate pass-through, drop- 
and-continue and service selector to assign. 

Pending, active and errored connection states are supported. A 
pending connection state is one in which the crossconnects associated 
with a connection are defined in the database, but have not been 
configured in the NEs. In an active connection, the crossconnects 
associated with a connection are defined in the database and also 
configured in the NEs. An errored connection exists when there is a 
discrepancy between the definition of the connection in NETSMART 
and the actual crossconnects in NEs. 

CrossConnect windows can be accessed from the Configuration 
Manager or by selecting CrossConnect Manager from the NETSMART 
menu. The crossconnect windows all bear the title "Configuration". 

Add a DSO Crossconnect 

Use this procedure to create redline and regular DSO 
crossconnects that drop off from the FACTR low-speed group (Group 
3, 4, and 5) feeder to the Remote Digital Terminal (RDT) inter- 
face/NBS. Tl crossconnects are created using the procedure found in 
Add a Tl Crossconnect, below. 

If the interface group is Integrated Network Access (INA) or TR- 
008 Mode I or III, the next available DSO time slot will be presented. 
If the interface group is TR-303 or TR-008 Mode II, the next Call 
Reference Value (CRV) number will be presented, and can be 
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overridden. NETSMART determines the DSO facility AIDs and sends 
the appropriate TLl commands. Figure 19 shows the DSO XC 
CrossConnect tab. 

Add a Tl CrossConnect 

Use this procedure to create the redline and regular DSl feeder 
side of an interface group and the Tl facility in the FACTR low-speed 
group (Groups 3, 4, and 5) feeder for DSO services. 

Crossconnects are limited by the following types of interface 
groups: 

TR-008 (Mode I)— Choose an available feeder DSl (A, B, C, or D). 

TR-008 (Mode II or III)— Choose an available feeder DSl (A or C). 

TR-303— Choose an available DSl (1 through 28). 

IN A — The Tl crossconnects are automatically created between the 
feeder of the INA interface group and the VTl of the low-speed 
group when the first DSO crossconnect is created. You cannot 
create them, but they can be displayed. 

Tasks: 

1 Log on the NE to be crossconnected. 

a. If CrossConnect Manager was selected from the NETSMART 

menu, the Configuration window displays. In the Configu- 
ration window, select the DSO XC tab. 

b. If the crossconnect needs to be a redline, click the Redline 

tool or select Redline from the Create XC selection on the 
Operations menu. 

c. Click on the DSl box to be connected, then drag the line to 

the port and click again. A dotted black line appears. 
Note: If the interface group or port (rectangle) is yellow, then it 
is already in use (possibly at a different speed). 
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d. To complete the connection, click the Update tool or select 
Update NE from the Operations menu. The Confirmation 
dialog displays 

Add a FASTLANE CrossConnect 

FASTLANE crossconnects are used to map Ethernet and DS3 
UNI services into an STS-1. FASTLANE™ service is only available for 
functional groups 4 and 5 configured as D3U or LAN bridge port 
(LBP). At least one dedicated STS-1 channel across the SONET ring 
must be available to carry the FASTLANE traffic. Two types of 
FASTLANE crossconnects are supported: 

Ethernet Port-Mapped Bridge (EPMB)— an entity connecting 
an EPMB to a ring-side Asynchronous Transfer Mode virtual channel 
(ATMVC) 

DS3 User Network Interface (D3UNI)— an entity connected to 
a particular ATMVC supported by a D3 UNI port to a ring-side 
ATMVC Ethernet port provisioning and ATMVC provisioning are 
performed independently of establishing crossconnects. Create ring-side 
ATMVCs to create a path through the network between the switches. 
The D3 UNI ATMVC ports are created by NETSMART. The value is 
shown for the next available Virtual Channel Identifier (VCI). You may 
override that channel selection. 
Tasks: 

1 Log on the NE to be crossconnected 

2 If the CrossConnect Manager was selected from the NETSMART 

menu, the Configuration window displays. In the Configuration 
window, select the FASTLANE XC tab. The Fastlane XC view 
(Figure 20) displays. 

3 Select Create ring VC from the Operations menu or right-click and 
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select Create Ring VC from the drop-down menu. The Ring VC 
creation dialog displays. 

4 Select or type values in the following fields: 

Ring VC VPI (0-0)— Type the Virtual Path Identifier (VPI). 

Only 0 is valid. Ring VC VCI (34-1023)-Type the VCI 

of the virtual channel. 
PCR— Type the Peak Cell Rate (PCR) per second. 
SCR— Type the Sustained Cell Rate (SCR) per second. 
Congestion Control— Select whether congestion control should 

be enabled or not. 
AAL-Type— Select the ATM Adaptation Layer (AAL). Only 

AAL5 is valid. 
From NE TID— The starting NE TID is the default value. 
To NE TID— Select the ending NE TID from the list. 

5 Click Ok to add the ring VC and close the Ring VC creation dialog. 

6 Click Apply to add the ring VC and leave the Ring VC creation 

dialog displayed. 

7 Click Cancel to cancel any changes and close the Ring VC creation 

dialog. If Ok or Apply was selected, the new VC displays in the 
middle of the FASTLANE XC window. 

8 Click on the appropriate port in the Group Configuration. On the 

FASTLANE XC tab, drag the mouse to the appropriate ring VC, 
then click again. A dotted line(s) will show the connection. 

9 To complete the connection, click the Update tool or select Update 

NE from the Operations menu. The crossconnect Confirmation 
dialog displays 

Add a SONET Crossconnect 

A SONET crossconnect connects STS or VT time-slot facilities. 
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A SONET CrossConnect can connect a high-speed time slot to another 
high-speed time slot (pass-through), a high-speed time slot to a low- 
speed time slot (add and drop), and a low-speed time slot to another 
low-speed time slot (hairpinning). Time slot rates must match for all 
SONET crossconnects. 

Note: For FLASH 192 2.x and 3.x NEs, not all AIDs can be 
interconnected. Only those AIDs that fan out from a SONET line 
that is green in color are open for crossconnects. 

Tasks: 

1 Log on the NE to be crossconnected 

2 If the CrossConnect Manager was selected from the NETSMART 

menu, the Configuration window displays. In the Configuration 
window, select the SONET XC tab. The SONET XC view 
(Figure 21) displays. 

3 Select the type of crossconnect (OneWay, TwoWay, 

One Way Broadcast, TwoWay Drop And Continue , 
TwoWay AddAndDrop, or Service Selector) from the Create XC 
option of the Operations menu or by clicking on the correspond- 
ing tool. 

Note: Not all types of crossconnect are available at all times 
(depending on the NE type and the configuration). 

4 If the crossconnect also needs to be a redline, click on the Redline 

tool or select Redline from the Create XC option on the Opera- 
tions menu. 

5 Click on the first STS or VTl group to be connected, then drag the 

line to the far-end STS or VTl group and click. A dotted line 
shows the connection. If a drop-type connection is required, 
click on the first STS or VTl group (left- or right-hand side), 
then click on the drop port along the bottom of the window and 
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dotted lines will be generated (including the appropriate right- 
hand group). 

Note: The time slot rates on both ends of this crossconnect must 
be equal. If the time-slot rectangle is yellow, then it is already 
in use (possibly at a different speed). 
6 To complete the connection, click the Update tool or select Update 
NE from the Operations menu. The crossconnect Confirmation 
dialog displays 

Add a Hairpin Crossconnect 

A hairpin is a crossconnect between two low-speed SONET 
termination points. 

Note: Hairpin crossconnects are supported for FLASH XC MV 
architecture. The FACTR or FLM 150 must have a TS1A-ENH2 
(time slot assignment) unit, which allows the low-speed 
crossconnects. The system type must be linear or Unidirectional 
Path Switched Ring (UPSR) and the NE device system parameter 
TSTYPE must be provisioned as ENH2. 
One-way, 2-way, bridge and roll crossconnects can be created, 
modified and deleted. Creation and deletion of redline crossconnects 
is supported. If a crosscormect is redlined, the redline must be removed 
before deletion. 
Tasks: 

1 Log on the NE to be crossconnected. 

2 If Crossconnect Manager was selected from the NETSMART menu, 

the Configuration window displays. In the Configuration 
window, select the SONET XC tab 

3 Select the Hairpinning option from the Operations menu. The 

HairPinning view (Figure 22) displays. 
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4 Depending on the type of crossconnect, select the One way or Two 

way tool or select the corresponding menu option from the 
Operations menu. If the crossconnect also needs to be a redline, 
click on the Redline tool or select Redline from the Create XC 
option on the Operations menu. 

5 Click on the first group to be connected from the From TP line, then 

drag the mouse to the appropriate group in the To TP group and 
click again. A dotted line will appear. 

6 When all of the crossconnects have been defined, click on the 

Update tool or select Update NE from the Operations menu. 

7 Verify the connections. If the connections are correct, click Ok. If 

the crossconnect was created successfully on the NE, the line(s) 
will change from dashed to solid. If the crossconnect on the NE 
fails, the crossconnect lines will remain dotted. If connections 
are not correct, click Cancel and then change the connections. 
The Confirm Connection dialog displays, indicating the success 
or failure of the crossconnect. 

Add a One- Way Service Selector Crossconnect 

The one-way service selector is used for the BLSR configuration 
for FLASH-192 and FLM-2400 SONET NEs. 
Tasks: 

1 Log on the NE to be crossconnected 

2 If Crossconnect Manager was selected from the NETSMART menu, 

the Configuration window displays. In the Configuration 
window, select the SONET XC tab. The SONET XC view 
(Figure 23) displays. 

3 Select the One Way service selector tool. Click on the low-speed 

port, then click on the destination high-speed port. The 
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CrossConnect displays as a dotted line. 

Note: The default Service Selector and Holdqff times can be 
changed at this time by right-clicking on a crossconnect and 
selecting the appropriate menu item. 
5 4 To complete the crossconnect, click on the Update tool or select 
Update NE from the Operations menu. 

Perforin a Bridge on an Existing Crossconnect 

Bridge crossconnect functionality is supported for BLSR 
configurations of FLASH-192 and FLM 2400 SONET NEs. By setting 
10 up a bridge, traffic from one termination point is routed to two other 
termination points. Bridge and roll operations are performed on two 
:| NEs to complete the entire task. First do a bridge on a crossconnect on 

one NE and then do the roll on the other NE. After the roll is 
performed, clear the bridge on the first NE. 



15 1 Log on the NE whose path is to be modified. 

2 If Crossconnect Manager was selected from the NETSMART menu, 
the Configuration window displays. In the Configuration 
window, select the SONET XC tab. The SONET XC view 
displays. 

20 3 Select the 1-way drop crossconnect to be bridged. 

4 Click the Bridge tool or select Bridge from the Operations menu. 

5 Select the destination time slot. The display will show the new bridge 

connection as a dotted line on the window when the operation is 
completed. 

25 6 To complete the connection, click the Update NE tool or select 
Update NE from the Operations menu. 
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Perform a Roll on an Existing CrossConnect 

Roll CrossConnect functionality is supported for the FLASH- 192 
and FLM 2400 SONET NEs. On an FLM 2400 SONET NE, this 
functionality is available only when the NE is configured as a BLSR. 
5 Rolling facilitates switching the source AID from one time slot to 
another time slot without loss of signal. Traffic is buffered by the NE 
during the roll operation. 

The roll operation can be performed by selecting a 1-way 
CrossConnect and then clicking the Roll tool or by selecting the Roll 
10 menu item from the Operations menu. After you select Roll, rubber 
banding starts and you can select a new origination point. A pending 
roll CrossConnect is created You can then activate the roll crossconnect, 
which results in deletion of the original crossconnect and creation of a 
new roll crossconnect. Bridge and roll operations are performed on two 
15 NEs to complete the entire task. 

First set a bridge on a crossconnect on one NE and then set a 
roll on the other NE. After the roll is performed, clear the bridge on 
the first NE. 

1 Log on the NE whose path is to be modified. 
20 2 If Crossconnect Manager was selected from the NETSMART menu, 
the Configuration window displays. In the Configuration 
window, select the SONET XC tab. The SONET XC view 
displays. 

3 Select the 1-way crossconnect to be rolled from. 
25 4 Click the Roll tool or select Roll from the Operations menu. A 

prompt displays directing you to select the destination time slot. 
5 Select the destination time slot. The display will show the new 

connection as a dotted line on the window when the operation is 
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completed. The old connection will be displayed as a solid line. 
6 To complete the connection, click the Update NE tool or select 
Update NE from the Operations menu. 

CrossConnect Confirmation 

The same dialog displays to confirm all types of crossconnects. 

1 To complete the crossconnect, click on the Update tool or select 

Update NE from the Operations menu. The crossconnect 
Confirmation dialog displays. 

2 Verify the connections. If the connections are correct, click Ok, If 

the crossconnect was created successfully on the NE, the line(s) 
will change from dashed to solid. If the crossconnect on the NE 
fails, the crossconnect lines will remain dotted. If connections 
are not correct, click Cancel and then change the connections. 
The Confirm Connection dialog displays, indicating the success 
or failure of the crossconnect. 

3 Click the Close button to close the Crossconnect Report. Figure 24 

shows the Crossconnect Report. 

Update the Crossconnect Name 

Crossconnects are not given a name when they are created. The 
name can be structured to conform to the user's own network naming 
convention; however, crossconnect names must be alphanumeric, with 
no special characters. Several crossconnects can be updated at the same 
time. 

Note: A crossconnect name must be alphanumeric and cannot 
contain any special characters. 
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1 Log on the NE with the crossconnect(s). 

2 If CrossConnect Manager v/as selected from the NETSMART menu, 

the Configuration window displays. In the Configuration 
window, select the SONET XC tab. The SONET XC view 
displays. 

3 Select the crossconnect that needs a new name. Select Set Name from 

the Operations menu, or right-click on the crosscormect and 
choose Set Name... . The Set Crosscormect Names dialog 
displays. 

4 Type a new name. 

5 Select the Set All button to move the crosscormect name to the 

CrossConnect Name field in the Set Crosscormect Names dialog. 
Click Ok to close the Set Crosscormect Names dialog. 

6 The cross-coimect displays as a dotted line. Click on the Update tool. 

The Confirmation dialog displays. Verify that the information is 
correct and click Ok. 

7 The Messages dialog box displays with the new name shown in the 

table. Click Ok. 

Adding Redline Designation to an Existing Crossconnect 

Adding a redline designation to a crosscormect indicates that it 
is a critical circuit and care should be taken when changes or discon- 
nects are issued that affect the crosscormect. 

1 Log on the NE with the crosscoimect(s 

2 From the Configuration Manager, select the SONET XC tab or DSO 

XC tab, depending on the type of crosscormect to be redlined. 
Figure 25 shows the DSO XC display. 

3 Select the crosscormect that needs to be redlined. Click the SetRedl 
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tool or select Set Redline from the Operations menu. Multiple 
crosscomiects can be chosen by holding down the SHIFT and 
CTRL keys, then clicking on the crossconnect lines. The 
CrossConnect line will change to a dotted red line. 
4 To complete the redline designation, click on the Update tool or 
select Update NE from the Operations menu. 

Delete a Crossconnect 

Most crossconnects can be deleted using this procedure. If the 
crossconnect is redlined, the redlining must be removed, as described 
this procedure. 

1 Log on the NE where the crossconnect is to be deleted. 

2 If Crossconnect Manager 'WdiS selected from the NETSMART menu, 

the Configuration window displays. In the Configuration 
window, select the appropriate tab: SONET XC, DSO, or 
FASTLANE. 

3 If the crossconnect is redlined, the redline designation must be 

removed first. Select the crossconnect and click the NoRed tool 
or select Unset Redline from the Operations menu. Click on the 
Update NE tool or select Update NE from the Operations menu. 
The Confirmation dialog displays. 

4 Click Ok to remove the redline. 

5 Click on the crossconnect to be deleted. Multiple crossconnects can 

be selected by holding down the CTRL and SHIFT keys and 
then clicking on each crossconnect to be deleted. 

6 Click on the DelXC tool or select Delete XC from the Operations 

menu. The crossconnect line changes from solid to dashed, 
indicating a pending change of state. 
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7 After all crossconnects have been marked for deletion in the GUI, 
make the changes to the NE by clicking the Update tool or select 
Update NE from the Operations menu. The crossconnect 
Confirmation dialog displays. 
5 8 Verify that the appropriate crossconnects are listed, then click Ok to 
complete the deletion. If the crossconnections are not correct, 
click Cancel and reselect the connections. If you cancel the 
deletion, click the Undo tool to reinstate the connection. 

Changing SSDEF 

The Service Selector Definition (SSDEF) is, by default, set to 
Insert. To reset the SSDEF to Thnx, perform the following procedure: 

1 Log on the NE where the SSDEF is to be reset. Access the appropri- 
ate crossconnect window. 

2 Right-click on a crossconnect to display a menu. 

3 Select Set SS to Thru. The menu selection Set SS to Thru changes to 
Set SS to Insert. You can toggle this selection between the two 
items. Only the inactive selection will display in the menu.. 

Changing the Holdoff Timer Value 

The holdoff timer is used to set the time interval after a 
protection switch when the NE will check the traffic origin and reset 
to that origin if possible. To change the holdoff timer value, perform 
the following procedure: 

1 Log on the NE where the holdoff timer is to be set. Access the 
appropriate crossconnect window. 
25 2 Right-click on a crossconnect to display a menu. 



10 



15 



20 
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3 Select Holdqff Timer. Type a value for the reset interval. 
Trace from a Time Slot 

If you are viewing a crossconnect with one termination point, but 
no crossconnect visible, you can discover the other end of this 
crossconnect. 

1 Log on the NE. Access the appropriate crossconnect window. 

2 Right-click to select a crossconnect and display a menu where you 

will choose Trace XC. A label will display beside the 
crossconnect termination point where you right-clicked. This 
label identifies the other end of this crossconnect. . 

Manage Facilities 

This section provides the procedures for defining and managing 
facilities for FLASH-192, FLM and FLASHWAVE NEs. Primary 
states for facilities are: In Service (IS), Out of Service Autonomous 
(OOS-AU), Out of Service Management or Memory Administration 
(OOS-MA) and Out of Service Autonomous Management (OOS- 
AUMA). Facilities can also have a secondary state of Out of Service 
Management Unassigned (OOS-MA :UAS) when they are manually 
deleted. 

Facilities can have secondary states of active (ACTI), normal 
(NR), abnormal (ANR), standby-hot (STBH), supporting entity outage 
(SGEO), facility failure (FAF), unassigned (UAS), and automatic in 
service (AINS). 

Add a Facility (FLASHWAVE or FLASH-192) 

Use this procedure to add fiber facilities for a FLASHWAVE or 
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FLASH-192 NE. 

Note: Facilities cannot be created unless supporting equipment 
has been created. 

Note: When creating or modifying OC-48/OC- 192 facilities in a 
Transponder type ofFLASHWAVE NE a message will ask you to 
provide directional attribute information. Always input the 
attributes (UNI or BI, for example) in upper case. 

1 From any tab in the Configuration Manager, select the Managing 

Facilities... option from the NE menu. The Managing Facilities 
dialog displays (Figure 26, Managing Facilities Dialog). 

2 Click on the rate and select the rate from the Rate drop-down list. 

Select the shelf from the Shelf droip-dov/n list. Select the facility 
in the Non-existing Facilities column. Click the Create tool. 
Note: If there are no nonexisting (deleted) facilities, there will be 
nothing in this list 

3 If this facility has any key attributes whose value should be specified 

at creation time, a dialog containing the key attributes will 
display. Enter the values for these attributes and click Ok. 

4 The selected attributes of the selected facility will display in the 

Attributes table. Click the Create tool. A Manage Facilities 
message box displays: Creating Facilities. The facility will be 
moved from the Non-existing to the Existing column and will be 
activated. 

Modify a Facility 

This procedure allows you to modify facilities. 

Note: When creating or modifying OC-48/OC-192 facilities in a 

Transponder type ofFLASHWAVE NE a message will ask you to 
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provide directional attribute information. Always input the 
attributes (UNI or BI, for example) in upper case. 

1 From the Configuration Manager, select the Groups /Facilities tab. 

2 Select the facility from the expanded tree or from the graphic area. 
5 The Attributes view displays. This display will vary slightly, 

depending on the command origin (issued from the tree or 
graphic area). 

3 Modify the required values shown in blue or red, then click the 

Modify tool or select the Update option from the Operations 
10 menu. Available operations include InSerw, OOSMA, OOSAfT, 

InSerw, Operate PSW and Release PSW (the particular opera- 
Ig tion(s) available will depend on the facility). The same options 

m can also be chosen from the Operations menu. 

Q 4 The values will be modified in the NE and the NETSMART database 

15 Delete a Facility. This procedure allows you to delete facilities 

Ic for a FLASHWAVE or FLASH-192 NE. 

V. 

Q 

yi Delete a Facility 

1 From any tab in the Configuration Manager, select the Managing 
u Facilities option from the NE menu. The Managing Facilities 

20 dialog displays. 

2 Select the shelf from the Shelf drop-down list. Click on the rate and 

select a rate from the Rate drop-down list. Select the facility in 
the Existing Facilities column. Click the Create tool. 
Note: If there are no existing (created) facilities, there will be 
25 nothing in this list. 

3 A confirmation dialog displays. Click Ok to delete the facility. The 

facility will be moved from the Existing Facilities to the Non- 
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existing Facilities column and will be deactivated 
Activate an FFP Group (FLASH-192) 

Fiber Facility Protection (FFP) groups are available for FLASH- 
192. The equipment and the facilities to support the FFP group must 
already be created. A list of FFP pairs is displayed and you will select 
the FFP to be created. 

Note: Changing FFP groups may change system configurations, 
which can cause system configuration inconsistencies. 

1 From any tab in the Configuration Manager, select the Manage FFP 

option from the NE menu. The Manage FFP dialog displays. 

2 Select the shelf from the drop-down list. Click on the rate and 

select the rate from the Rate drop-down list. Select the FFP in 
the Non-existing FFP column. 

Note: The list will be empty If there are no nonexisting (deleted) 
FFPs. 

3 Click the Create tool. 

4 The FFP will move from the Non-Existing FFP to the Existing FFP 

column and will become active. 

Modify (or View) an FFP Group 

The FFP group attributes for NEs can be modified, by perform- 
ing the following tasks: 

1 From the Configuration Manager, select the FFP tab 

2 Select the FFP group from the expanded tree or double-click on the 

FFP in the graphic area. The Attributes tab for the group 
displays. 
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3 Modify the required values shown in blue and red by clicking on the 

value, then select the new option from the drop-down list. 

4 Click the Modify tool to download the changes to the NE. The 

changed values will be displayed in the Value column. 

Deactivate an FFP Group (FLASH-192) 

Active FFPs for a FLASH-192 can be deactivated, by perform- 
ing the following tasks: 

1 In any tab in the Configuration Manager, select the Manage FFP 

option from the NE menu. The Manage FFP dialog displays. 

2 Select the shelf from the drop-down list. 

3 Select the rate from the Rate drop-down list. 

4 Select the FFP in the Existing FFP column. 

5 Select Delete from the Edit menu. The FFP will be moved from the 
Existing FFP to the Non-Existing FFP column and will be deactivated. 

Managing Waveleng ths 

Use the NETSMART Wavelength Management feature to 
produce a report about wavelength inventory in your network. The 
report includes: 

s Wavelength (in nm) 

? Frequency (in THz) 

5 Part number for narrowband optics or transponder card 
i AID 

s Wavelength availability and primary status 
: OCN WLR (Optical Carrier Level n Wavelength Received) 
i OCN OPR (Optical Carrier Level n Optical Power Received) 
^ WCH OPT (Wavelength Channel Optical Power Transmitted) 
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« WDM OPR (Wavelength Division Multiplexer Optical Power 
Received) 

t WDM OPT (Wavelength Division Multiplexer Optical Power 
Transmitted) 

Note: To avoid confusion, the window display is static (is not 
updated) once the view is requested. You must use the Reload 
tool or the Reload NE List command to redisplay the window and 
view updated information. 



Wavelength Support 

The following wavelengths are supported: 

Wavelength (nm) Frequency (THz) lOG Part Number 

1535.82 195.2 08 

1536.60 195.1 09 

1537.39 195 10 

1538.18 194.9 11 

1538.97 194.8 12 

1539.76 194.7 13 

1540.55 194.6 14 

1541.34 194.5 15 

1542.14 194.4 16. 

Produce a Wavelength Inventory Report 

The Wavelength Management window can be started from any 
application with a NETSMART menu item. 

Wavelength (nm) Frequency (THz) lOG Part Number. 

1542.93 194.3 17 

1543.73 194.2 18 

1544.52 194.1 19 
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If you open this window from the Topology window, the following 
selections are available: 
^ Select a number of NEs. 
^ Select a number of groups. 
25 « Select a number of NEs and groups, 
t Select the Network group. 

If any of these selections are made, the Wavelength Management 
window displays with only the selected FLASH WAVE terminals. 
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Otherwise, all existing FLASH WAVE terminals are displayed To 
produce a wavelength inventory report, perform the following tasks: 

1 From the NETSMART menu, select Wavelength Management. The 

Wavelength Management window displays. 

2 The list area contains a list of all FLASH WAVE terminal NEs. Click 

on an NE to display its data. 

3 To filter the columns of the data display, select the Filter tool from 

the toolbar. 

4 Click on the first button below the Field label. A list of values to 

filter with displays. Values include Wavelength (nm), Frequency 
(THz), Transponder or 10 G part #, AID, Status, OCN WLR, 
OCN OPR, WCH OFF, WDM OPR, and WDM OPT. Click to 
select one of these values. 

5 Once a filtering value has been selected, the Test button becomes 

active. Click on the Test button to display a series of values to 
test against for filtering; one of: 

« contains 

* .'contains 

^ starts with 

^ .'starts with 
ends with 

^ : ends with 

6 Click to select one of the values listed above. Boolean values can be 

used to filter by selecting one of and / or from the Logic button. 

7 Once all filtering values are selected, click Ok to redisplay the 

Wavelength Management values with the filter(s) applied. 

NGDLC Services 
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Next generation digital loop carrier (NGDLC) systems enable 
carriers to provide integrated access between the customer premises and 
the public network. NGDLC supports concentration of switched traffic 
and grooming of non-switched traffic. 

You may view and edit Next Generation Digital Loop Carrier 
services including the TR-008, TR-303, or INA interface groups for a 
FACTR NE. Each of these groups is created by autodiscovery. Choose 
the mode (I, II, or III), the mapping sequence (DID or D4) and the 
bypass pair option (1 or 2). TR-303 defines an interface between a 
central office switch and a remote terminal to handle all call processing 
and operational functions for the DLC system. TR-303 is a versatile 
interface supporting a large number of subscribers and transport 
bandwidth, providing carriers with the ability to choose a concentration 
ratio geared to traffic engineering guidelines. For TR-303 DSOs, the 
NETSMART user can see the assigned Call Reference Value (CRV), 
which is a number between 1 and 2016 that is assigned to a TR-303 
DSO. 

Edit a TR-008 or TR-303 Interface Group 

This procedure edits TR-008 and TR-303 parameters for those 
NEs that support these interfaces. It also places the interface in service 
or, for maintenance purposes, out of service. Placing an NE in 
maintenance state is not service affecting. However, once an NE has 
been placed in a maintenance state, actions performed on that NE may 
be service affecting (a loopback, for instance, is service affecting). 

1 Log on the NE. 

2 From the Configuration Manager, select the Interface Type tab. The 

Interface Type tab displays. 
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3 A blue dot in the upper right-hand corner indicates that an interface 

group has children. Double-click the TR-008 or TR-303 box in 
the graphical area or, in the expanded tree, select the item that 
corresponds to the interface to be modified. The Attributes 
dialog displays. 

4 Click on the interface option to be changed. Only interface options 

displayed in blue can be changed. Select the new option from the 
drop-down list 

5 Click the Modify tool or select the Update option from the Opera- 

tions menu to make the changes. 

6 Click to select the tool for the correct operation: InSerw, OOSMA, 

OOSMI. The same options can also be chosen from the Opera- 
tions menu. 

Edit an INA Interface Group 

This procedure allows the user to modify INA interface attributes 
and put Tls in service or take them out of service for maintenance. 
Placing an NE in maintenance state is not service affecting. However, 
once an NE has been placed in a maintenance state, actions performed 
on that NE may be service affecting (a loopback, for instance, is 
service affecting). 

1 Log on the NE. 

2 From the Configuration Manager, select the Interface Type tab. 

3 A plus sign to the left of an interface group indicates that this 

interface group has children. Expand the tree list and select the 
Tl to be modified. 

4 The Attributes dialog (Figure 27) displays. 

5 Only interface options displayed in red or blue can be changed. 
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Select a new option from the drop-down list that is displayed 
when the value is clicked. 

6 Click the Modify tool to complete the changes. 

7 Click to select the tool for the correct operation: InSerw, OOSMA, 

or OOSMT. The same options can also be chosen from the 
Operations menu. 

Performance Management 

Performance Management is an optional feature and is started 
using a different NETSMART command than the regular startup 
command. If you cannot access this feature, please contact your 
NETSMART administrator. For information about enabling and 
disabling Performance Management, refer to "NETSMART Optional 
Features" in the NETSMART Installation and Administration Guide 
(FJTU-320-940-150). 

A NETSMART user needs a way of accessing the PM Monitor- 
ing parameters on a Network Element (NE) to determine how an NE 
is performing in the network. The PM feature provides the mechanism 
for the user to query and set PM Monitoring parameters on one or 
more NE(s). A comprehensive listing of PM parameters for each NE 
can be found in the appropriate NE manual. Most PM operations may 
be applied to one or more NE(s), to multiple cards or facilities on a 
single NE, or to a single card or facility on a single NE. Use Perfor- 
mance Manager to: 

« Enable and disable a performance monitoring report 
« Retrieve performance monitor reporting status 
9 Initialize the performance registers for an NE 
* Set individual threshold values 
« Retrieve current threshold values 
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^ Retrieve historical performance data 

Operations that can be applied only to a single card or facility on a 
single NE are: 

^- Setting of individual threshold values 
5 # Retrieval of current threshold values 

i Retrieval of performance data 

Management Procedures 

This section describes the procedures for using the Performance 
Manager. Performance Manager is supported for the following NEs: 
10 # FLASH-192 (02.03) 
^ FLASH-192 (04.02) 

ii FLASHWAVE (02.01) 
# FLASHWAVE (0L03) 

^ ELM 2400 ADM (14.02S). 
15 ^ ELM 2400 ADM (14.02BS) 
ELM 600 ADM (14.02) 

You can display the Performance Manager window in three 
different views, depending on how the window is accessed. Views 
include: Element View, Equipment View and Groups/Facilities View. 
20 Element View: Accessing Performance Manager from the Topology 
window displays the Element View. 
Equipment View: Accessing Performance Manager from the Configu- 
ration Manager - Equipment Tab displays the Equipment View. 
Groups/Facilities View: Accessing Performance Manager from the 
25 Configuration Manager Groups/Facilities tab displays the 

Groups/Facilities View. 
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Performance Manager Element View 

To display Performance Manager in Element View, select an NE 
or several NEs in the Topology window and then select Performance 
Management from the NETSMART menu. If no NEs are selected, a 
list of available NEs will be displayed in the Performance Manager 
window after it is launched. The view is divided into two main parts. 
The Selection area in the top portion of the view displays selected 
elements in the Selected Elements list. Radio buttons to the right of the 
Interval label are used to define a monitoring interval. The bottom 
portion of the view displays monitoring data. 

Start and Stop Monitoring 

Note: If the Performance Manager was started from a selected 
NE or NEs, there will be no elements in the Available Elements 
list and the selected NE(s) will be displayed in the Selected 
Elements list. If you started Performance Management from the 
NETSMART menu with no NE selected, all NEs will be displayed 
in the Available Elements list. The following information assumes 
that Performance Management was selected from the Operations 
menu with no NE selected (all NEs will appear in the Available 
Elements list). 

1 To begin monitoring, select the Monitors tab in the Performance 

Manager window. This is the default tab for the Element view. 

2 To select NEs to monitor, select an item in the Available Elements 

column and use the Add button to add it to the Selected Elements 
column. 

3 To remove an item from the Selected Elements column, highlight the 

item in the Selected Elements column and click the Remove 
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button. After the in-progress message bar disappears, the entry 
is added to the monitoring data area. Verify the status of the 
initialization in the third column. 

4 To add all items to the Selected Elements column, click the Add All 
5 button. 

5 To remove all the items in the Selected Elements column, click the 

Remove All button. After the in-progress message bar disappears, 

the entry stays in the list, but the status is changed to Disable. 

Note: When it is impossible to use a selection, that selection is 
10 grayed'OUt, For example, in PM Element View (from NE): 

Monitors Tab the Add and Add All buttons cannot be used 

because there is nothing in the Available Elements: list to add. 

The Remove button cannot be used until an element in the 

Selected Elements: list is selected. 
15 6 Define the interval for monitoring using the Interval radio button. 

Options are 15 Min. (15-minute intervals) or 1 Day. The default 

value is 15 minutes. If you select 15 Min., data is retrieved from 

the NE 15-minute registers. If you select 1 Day, data is retrieved 

from the NE 1-day registers 
20 7 Click the Mon On tool in the toolbar or select Turn Performance 

Monitoring On from the Operations menu (Figure 28). 
8 To stop monitoring, select the Monitors tab and then click the Mon 

Ojf tool in the toolbar or select Turn Performance Monitoring Off 

from the Operations menu. 

25 Initialize Registers 

To reset all registers to zero values, you will initialize the 
registers. To initialize registers: 
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1 Select the Registers tab in the Element view (Figure 29). 

2 To select NEs to initialize, select an item in the Available Elements 

column and use the Add button to add it to the Selected Elements 
column. 

3 To remove an item from the Selected Elements column, highlight the 

item in the Selected Elements column and click the Remove 
button. 

4 To add all items to the Selected Elements column, click the Add All 
button. 

5 To remove all the items in the Selected Elements column, click the 

Remove All button. 

Note: When it is impossible to use a selection, that selection is 
grayed out. For example, in PM Element View (from NE): 
Monitors Tab the Add and Add All buttons cannot be used 
because there is nothing in the Available Elements: list to add. 
The Remove button cannot be used until an element in the 
Selected Elements: list is selected. 

6 Select the Init tool in the toolbar or select Initialize Performance 

Registers from the Operations menu. Selecting this option will 
initialize all the registers in the NEs to zero (Initialized 

Retrieve Performance Data 

Occasionally you will want to retrieve performance data for 
reporting or analysis. To retrieve performance data, perform the 
following tasks: 

1 Select the Database tab in the Element view (Figure 30). 

2 Select the element(s) from the Available Elements list. 

3 Use the Add button to add it to the Selected Elements column. 
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4 To remove an item from the Selected Elements column, highlight the 

item in the Selected Elements column and click the Remove 
button. 

5 To add all items to the Selected Elements column, click the Add All 
button. 

6 To remove all the items in the Selected Elements column, click the 

Remove All button. 

Note: When it is impossible to use a selection, that selection is 
grayed out. For example, in PM Element View (from NE): 
Monitors Tab the Add and Add All buttons cannot be used 
because there is nothing in the Available Elements: list to add. 
The Remove button cannot be used until an element in the 
Selected Elements: list is selected. 

7 Select or type values in the following fields: 

Interval— Displays the time period interval. Possible options are 
15 Min. or / Day. The default is 15 minutes. If you select 15 
Min. the collected data will be divided into 15-minute periods. 
If you select 1 Day, the collected data will be reported in 1-day 
periods. 

NMS Start Date— Select the date when NETSMART started 
receiving data from the NE. A default format is provided. 
NMS Start Time— Select the time when NETSMART started 
receiving data from the NE. 

NMS End Date— Select the date when NETSMART stopped 
receiving data from the NE. 

NMS End Time— Select the time when NETSMART stopped 
receiving data from the NE. 

8 Select Reload from the Operations menu or click the Reload tool 

from the toolbar to start retrieving data. 
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Performance Manager Equipment View 

To display the Performance Manager Equipment view, select a 
card in the Configuration Manager Equipment tab and then click on the 
Retrieve tool in the toolbar. Otherwise, right-click to display a pop-up 
5 menu and then select Display PM from the pop-up menu. If a card does 
not have PM registers, the PM tool will not be displayed in the toolbar 
Figure 31 shows the Performance Manager Equipment view. The 
Equipment view displays only the Registers tab and facilitates setting 
register thresholds and retrieving current performance registers. Fields 
10 in the display include: 

- NMS Time— NETSMART time. 
^ NE Time— The time on the NE. 
AID Type— Type of Access Identifier. 
AID— Access Identifier name. 
15 ^ Register— Register name. 

= Val ue— Value of the register that was retrieved. 
^- Range— Allowable range for the register Value. 

Threshold— Indicator to the NE to regenerate the threshold report 
if the threshold was exceeded. 
20 = Default Threshold— When an NE is first started, this is the default 
value set by the NE. This value can be reset using the procedure 
described in "Set Threshold". 
^ Validity— This value is valid only for FLASH-192 and 
FLASH WAVE NEs. Under normal operating conditions, this 
25 value should be FALSE. PM registers are accumulated in 15- 

minute intervals; if any data being reported is not for the full 15- 
minute interval this value will be reported as TRUE. 
^ Location— This value indicates where the data is coming from (near- 
end or far-end). Equipment registers will always be far-end. 
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^ Direction— For equipment, this will always report N/A as the 
physical characteristics of equipment have no direction. Typically 
the value reported for facilities will be Tx or Rx. 

t Time Interval— This value is always N/A for equipment. For 
facilities the time reporting interval will be displayed as either 15 
MIN or 1 DAY. 

Index— This value will always be 0 for equipment. For facilities, the 
current register (0) plus previous registers 1 to 32 will be 
displayed. The Monitors and Database tabs cannot be selected, 
because equipment registers are not counters; they are current 
operating levels for items such as Laser Bias Current Normalized 
(LBCN). Because of this, monitoring cannot be turned on or off 
and the database will not contain any historical data. 

Set Threshold 

Performance monitoring registers can, potentially, be collected 
for thousands of circuits, creating an overwhelming amount of data. To 
limit this data, thresholds for data collection can be set. If these 
thresholds are not crossed, the assumption is that the NE performance 
is acceptable. A default threshold value exists for each register. The 
threshold for any register can be set and changed. To set thresholds: 

1 Select equipment from the Available Equipment list and click the Add 

button to add the equipment to the Selected Equipment list 

2 Select a numbered row in the report and then click the Set tool in the 

toolbar. The Set Thresholds dialog displays. 

3 Type a new value for the threshold. Threshold ranges are NE- 

dependent and are displayed when you select the row that you 
will set registers for. You can also refer to the System Engineer- 
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ing section of the Fujitsu Network Communications web site for 
the TLl threshold value specification for each NE. 
4 Click OK to select the threshold and close the dialog. 

Retrieve New Data 

To retrieve new performance data: 

1 Select equipment from the Available Equipment list and click the Add 

button to add them to the Selected Equipment list. 

2 Select the Reload tool from the toolbar. The Reload tool updates the 

report for the equipment contained in the Selected Equipment list 
and for the values specified in the Location, Direction, Time 
Interval, and Iruiex fields. 

Performance Manager Groups/Facilities View 

To display Performance Manager in the Groups/Facilities View, 
select a facility in the Configuration Manager Groups /Facilities tab and 
then click on the Retrieve tool in the toolbar. Otherwise, right-click to 
display the pop-up menu and then select Display Performance from that 
pop-up menu. The Monitor tab is the default initial display. 

If a facility has PM registers, when that facility is selected, the 
PM tool will become active in the toolbar. Figure 32 shows the 
Performance Manager window in the Groups/Facilities view. The 
Groups/Facilities view contains the Monitors, Registers, and Database 
tabs and allows you to turn reporting on or off, to retrieve current PM 
registers from the facility and to retrieve historical data from the 
database. The Monitors tab is grayed-out on any group/facility that 
does not support performance monitoring. By default, the facility 
selected in Configuration Manager is the one displayed in Performance 
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Manager and the Interval option is set to 15 Min. (the default). Fields 

in the display include: 

« NMS Time— NETSMART time. 

# NE Time— The time on the NE. 

^ AID Type — Type of Access Identifier. 
^ AID — Access Identifier name. 

* Register — Register name. 

« Value — Value of the register that was retrieved. 

^ Range — Allowable range for the register Value. 

i Threshold— Indicator to the NE to regenerate the threshold report 
if the threshold was exceeded. 

« Default Threshold— When an NE is first started, this is the default 
value set by the NE. This value can be reset using the procedure 
described in "Set Threshold". 

i Validity— This value is valid only for FLASH- 192 and 
FLASH WAVE NEs. Under normal operating conditions, this 
value should be FALSE. PM registers are accumulated in 15- 
minute intervals; if any data being reported is not for the full 15- 
minute interval this value will be reported as TRUE. 

« Location— This value indicates where the data is coming from (near- 
end NEND or far-end FEND). 

■» Direction— Typically the value reported for facilities will be Tx or 
Rx. 

« Time Interval— For facilities the time reporting interval will be 
displayed as either 15 MIN or 1 DAY. 
Index— For facilities, the current register (0) plus previous registers 
1 to 32 will be displayed 

Start and Stop Monitoring 



App'n of Fujitsu Network Communications, Inc.: FN-3014 



Page 92 



1 To start monitoring, select the Monitors tab in the Performance 

Manager Groups/Facilities view. The reporting status is automat- 
ically retrieved and displayed. 

2 To select NEs for monitoring, select an item in the Available 
5 Facilities list and use the Add button to add it to the Selected 

Facilities list. By default, the facility that is selected when 
Performance Manager is launched is already in the Selected 
Facilities list. 

3 To remove an item from the Selected Facilities column, highlight it 
10 in the Selected Facilities column and click the Remove button. 

4 To add all the items to the Selected Facilities column, click the Add 

All button. 

5 To remove all the items in the Selected Facilities column, click the 

Remove All button. 

15 6 Choose the location by selecting one of the Location radio buttons. 
Possible choices are NEND (near-end) or FEND (far-end). 
7 Choose the direction by selecting one of the Direction radio buttons. 
Possible choices are Receive, Transmit or NA (Not Applicable). 
This list is dynamically updated based on the selected facility. 

20 8 Select the interval for monitoring using the Interval: radio button. 

Options are 15 Min. or 1 Day. The default is 15 minutes. If you 
select 15 Min., data is retrieved from the NE 15 -minute regis- 
ters. If you select 1 Day, data is retrieved from the NE 1-day 
registers. 

25 9 In the Start Index and End Index fields, select a value between 0 and 
32 for registers. 0 is the current register and there may be up to 
32 previous registers. The End Index value must always be 
higher than the Start Index value. 
10 Click the Mon On tool in the toolbar to start monitoring. 
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11 To stop monitoring, select the Monitors tab and then click the Mon 
Oj^tool in the toolbar 

Initialize Performance Registers 

To initialize performance registers: 

1 Select the Registers tab in the Groups/Facilities view. 

2 Select the Init tool in the toolbar. Selecting this option will initialize 

all the selected NE facility registers to zero. 

Retrieve Register Data 

To retrieve register data, select the Registers tab in the PM 
Groups/Facilities view. Once this tab is selected, a command is sent to 
the NE to retrieve register data for the selected facility. This data is 
displayed using the default parameters for Location, Direction, Interval 
and Start and Stop Indexes. 

Reload Register Data in the Report 

To reload new register data while in the Registers tab: 

1 Select the facilities from the Available Facilities list and click the 

Add button to add them to the Selected Facilities list. 

2 Choose the location by selecting one of the Location radio buttons. 

Possible choices are NEND (near-end) or FEND (far-end). 

3 Choose the direction by selecting one of the Direction radio buttons. 

Possible choices are Receive, Transmit or NA (Not Applicable). 
This list is dynamically updated based on the selected facility. 

4 Select the interval for monitoring using the Interval radio button. 

Options are 15 Min. or 1 Day. The default is 15 Min. If you 
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select 15 Min., data is retrieved from the NE 15-minute regis- 
ters. If you select 1 Day, data is retrieved from the NE 1-day 
registers. 

5 In the Start Index and End Index fields of the Registers tab, select a 
5 value between 0 and 32 for registers. 0 is the current register 

and there may be up to 32 previous registers. The End Index 
value must always be higher than the Start Index value. These 
choices may be dynamically updated, depending on the selected 
type of facility. 

10 6 Select the Reload tool in the toolbar. Selecting this tool will reload 
the register data for the selected facility for the index selected in 
Step 2 and will display the results in the window.. 

^ Set Threshold 

\^ 

!□ You can set and change the current threshold for any register. To 

|i' 15 set thresholds, from the Performance Manager: 

JU 1 Select the Registers tab in the Groups/Facilities view. 

^^1 2 Select facilities from the Available Facilities list and use the Add 

jS button to add them to the Selected Facilities list. 

■!f 3 Select a numbered row in the report and then click the Set tool in the 

20 toolbar. After the Set Thresholds dialog displays, type a new 

value for the threshold. 
4 Click Ok to save the changes and close the dialog.. 



Retrieve Historical Data 

To retrieve historical data for the selected facility in the Facility 

25 View: 



App'n of Fujitsu Network Communications, Inc.: FN-3014 



Page 95 



1 Select the Database tab in the Groups/Facilities view. 

2 Select elements from the Available Elements list and click the Add 

button to add them to the Selected Elements list. Select Add All 
to add all elements. 
5 3 Select the interval for monitoring using the Interval radio button. 

Options are 15 Min. or 1 Day. The default is 15 minutes. If you 
select 15 Min., data is retrieved from the NE 15-minute regis- 
ters. If you select 1 Day, data is retrieved from the NE 1-day 
registers. 

10 4 Type values in the following fields: 

NMS Start Date— Select the date when NETSMART started 
receiving data from the NE. 

NMS Start Time— Select the time when NETSMART started 
receiving data from the NE. 
15 NMS End Date— Select the date when NETSMART stopped 

receiving data from the NE. 

NMS End Time— Select the time when NETSMART stopped 
receiving data from the NE. 
5 Click the Reload tool from the toolbar to begin retrieving data. The 
20 resulting report is updated for the elements in the Selected 

Elements list and for the specified Interval, NMS Start Date, 
NMS Start Time, NMS End Date, and NMS End Time. 

TLl Command and Batch Processing 

This section provides the procedures for entering and executing 
25 both batch and online TLl conmiands. Batch TLl commands can be 
saved as a file and executed at a later time. 

To start the TL-1 Editor, from the Configuration Manager 
NETSMART menu, select TLl Editor. The Raw TL-1 / TL-1 Batch 
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window displays. There are three main display areas on this window. 
^ The upper part will contain any commands that were typed in the 

TLl Command text entry area 
i The middle part will contain any results/responses generated by this 

command. 

^ The lower part contains the TLl Command text entry area, the 
Active Sessions list area and the list of saved batch files. This 
procedure refers to the upper portion of this window as the 
history area and the middle portion is referred to as the re- 
sults/responses area. The lower portion of the window is referred 
to as the batch listing area. 

Enter Single TLl Commands 

Use the Raw TL-1 / TL-1 Batch window to enter and execute 
individual TLl conmiands. Using individual TLl commands is the 
simplest way to interact with a single NE and will ensure that the 
command executes properly before using it in a batch file (especially 
one that will be executed on multiple NEs). When executing time- 
consuming TLl commands, it is best to use a TLl batch (when 
individual TLl commands are sent for execution, the TLl Editor 
remains busy waiting for command response). 

1 In the Raw TL-1 / TL-1 Batch Window, type in the TLl command 

in the TLl Command field. 

2 Press the ENTER key to execute the command. The conmiand 

displays in the history area of the TLl window. The command 
and the results display in the results/responses area of the TLl 
window. Each TLl session corresponds to a user ID that is 
logged on a specific NE. Multiple sessions can exist. An active 
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session must exist to send a command. If no sessions exist, one 
can be created by issuing the ACT-USER TLl command. 



Enter TLl Commands in Batch Mode 

TLl conmiands can be entered into a batch file for immediate 
5 execution or can be saved in a batch file for a scheduled execution. 
Before a batch can execute, at least one TID must be selected. In 
addition, the batch must have the UID and Password properties set 
before the batch can execute. 

Batch commands can be exported as a file, in which case the TID 
10 and Properties values will not be retained. Importing a TLl file into 
the TL-1 Batch Editor will override any existing commands in the 
editor. The command syntax for TLl commands is described in 
Bellcore document GR-831-CORE Issue 1 (November 1996). 

1 In the Raw TL-1 / TL-1 Batch window, select New from the Batch 
15 menu to display the NETSMART TL-1 Batch Editor window, 

where you can create a new batch. To edit an existing batch, 
double-click on an existing batch in the batch listings at the 
bottom of the window or click on a batch name and select Edit 
from the Batch menu. The NETSMART TL-1 Batch Editor 
20 window displays (Figure 4-144). 

2 Select TIDs from the Batch menu. The TID List dialog displays. 

3 Select the TID(s) for the batch by clicking to highlight the TID to 

which the TLl commands will be sent. Multiple TIDs can be 
selected. Click a second time on the TID to deselect any 
25 unwanted values. 

4 If the TID that is needed is not in this list, type the name of the TID 

in the list to the left of the Add TID to List button. 
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5 Click the Add TID to List button to add the TID to the list. If there 

are no TIDs to add, this button is grayed out and unavailable. 

6 Click Ok to select the TID(s). 

7 Use the Import Batch tool to display the Import Batch dialog where 

the file to be imported can be identified, or use the Export Batch 
tool to display the Import Batch dialog where the location and 
file name for data to be exported can be identified. 

8 Click to select the file to be imported or exported. Only one file at 

a time can be selected. 

9 Click OK to select the file and close the dialog. 

10 Click the mouse to place the cursor in the free-form area of the 

NETSMART TL-1 Batch Editor (the main part of the window) 
and type TLl commands in this area. 

11 To set the properties for the batch, click on the Props tool or select 

Properties from the Batch menu. The Batch Properties dialog 
displays. Values must be entered in the UID and Password fields 
for the batch to execute. 

12 Select or type values in the following fields: 

Name: — If this is a new batch, this field is blank. If this is an 
existing batch, this field displays the name of the batch. Data 
cannot be entered in this field. 

Owner — Displays the user name that logged on NETSMART. 
Data cannot be entered in this field. 

Privilege:— Select PRIVATE if only the person who created the 
batch file can execute it or PUBLIC if any user with TLl 
privileges can execute the batch file. 

Send Mode:— Select SERIAL if the TLl batch of commands is 
to be sent to one NE at a time or PARALLEL if the batch file is 
to be sent to all NEs in the TID list at the same time. 
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UID:— Type the user ID that will be used to create a new session 
for batch execution. This user ID must be valid for each TID 
that was selected using the TID List dialog. If a command within 
the batch file specifies another user ID, the user ID within the 
batch file will override this user ID. 

Password:— Enter the password for the User ID that was typed 
in the UID field. 

13 Click Ok to save the property settings or Cancel to close the dialog 

without making changes. 

14 To save the batch file, click the Save As tool or select Save As from 

the File menu. 

The Save As Dialog 

Use the Save As... dialog to save a file with the existing name 
(overwrites the existing file) or to type a new filename and save the file 
with the new name. 

1 When the Save As... dialog displays, type a value in the Batch name 

field. The file will be saved using this name. 

2 In the Raw TL-1 / TL-1 Batch window, double-click to select a 

saved batch file from the listing area (the lowest portion of the 
TLl window). If there is more than one session active, select the 
active session TID from the Active Sessions list. Click the Send 
tool or select Send from the Batch menu to transmit the TLl 
commands. 

Edit TLl Batch Commands 

The TLl batch file can be edited and saved in the original file or 
in a new batch file for a scheduled execution. The new batch must have 
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the UID and Password properties set before the batch can execute. 
Batch commands can be exported as a file, in which case the TID and 
Properties values will not be retained. Importing a TLl file into the 
Batch Editor will override any existing commands in the editor. The 
5 command syntax for TLl commands is described in Bellcore document 
GR-831-CORE Issue 1 (November 1996), which is hereby incorporated 
by reference. 



1 In the Raw TL-1 / TL-1 Batch window, either double-click on an 
existing batch in the batch listings at the bottom of the window 
10 or click on a batch name and select Edit from the Batch menu. 

The NETSMART TL-1 Batch Editor window displays. 
Jfl 2 To add or change TIDs, select TIDs from the Batch menu. The TID 

List dialog displays. 

ii 3 Select the TID(s) for the batch by clicking to highlight the TID to 

i^f 15 which the TLl commands will be sent. Multiple TIDs can be 

selected. Click a second time on the TID to deselect any 
P unwanted values. 

4 If the TID that is needed is not in this list, type the name of the TID 

n ii 

jjl in the list to the left of the Add TID to List button. Click the Add 

]3 20 TID to List button to add the TID to the list. If there are no 

TIDs to add, this button is grayed out and unavailable. 

5 Click Ok to select the TID(s). 

6 Use the Import Batch tool to display the Import Batch dialog where 

the file to be imported can be identified, or use the Export Batch 
25 tool to display the Import Batch dialog where the location and 

file name for data to be exported can be identified. 

7 Click to select the file to be imported or exported. Only one file at 

a time can be selected. 
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8 Click OK to select the file and close the dialog. 

9 Click the mouse to place the cursor in the free-form area of the 

NETSMART TL-1 Batch Editor (the main part of the window) 
and type TLl commands in this area. 

10 To modify the properties for the batch, click on the Props tool or 

select Properties from the Batch menu. The Batch Properties 
dialog displays. Values in the UID and Password fields must be 
changed so that the batch can execute. 

11 Select or type to change values in the following fields: 

Name: — If this is a new batch, this field is blank. If this is an 
existing batch, this field displays the name of the batch. Data 
cannot be entered in this field. 

Owner— Displays the user name that logged on to NETSMART. 
Data cannot be entered in this field. 

Privilege:— Select PRIVATE if only the person who created the 
batch file can execute it or PUBLIC if any user with TLl 
privileges can execute the batch file. 

Send Mode:— Select SERIAL if the TLl batch of commands is 
to be sent to one NE at a time or PARALLEL if the batch file is 
to be sent to all NEs in the TID list at the same time. 
UID:— Type the user ID that will be used to create a new session 
for batch execution. This user ID must be valid for each TID 
that was selected using the TID List dialog. If a command within 
the batch file specifies another user ID, the user ID within the 
batch file will override this user ID. 

Password:— Enter the password for the User ID that was typed 
in the UID field. 

12 Click Ok to save the property settings or Cancel to close the dialog 

without making changes. 
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13 To save the batch file, click the Save As tool or select Save As from 

the File menu. 

14 When the Save As... dialog displays, type a value in the Batch name 

field or leave the old name if you do not want to change it. The 
file will be saved using this name. 

15 In the Raw TL-1 / TL-1 Batch window, doiible-click to select a 

saved batch file from the listing area (the lowest portion of the 
TLl window). If there is more than one session active, select the 
active session TID from the Active Sessions list. Click on the 
Send tool or select Send from the Batch menu to transmit the 
TLl commands. 

Using the TLl Console 

This section provides the procedures for using the TLl Console. 
The TLl Console window allows a user to view the TLl activity 
generated due to a user's actions; for example, log on to NE, create 
CrossConnect, etc. System-level TLl activities include all the TLl 
activities that are sent to or received from the NEs being managed, 
such as TLl command and response, autonomous messages (REPT-*), 
raw TLl command and response, and RTRV-HDR. 

By default, all security roles defined in NETSMART have the 
TLl Console user function, which allows users to view the TLl 
activities that they generated. The NetSmartUser Admin role has the 
TLlSuperConsole function, which allows users to view the system TLl 
activities. If the role includes the TLlSuperConsole user function, the 
user with this role can use the TLl Console window to view system- 
level TLl activities. As a TLlSuperConsole user, up to five TLl 
Console windows can be started. By default, the TLl messages viewed 
by the TLl Console user include the command and response received 
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from the NE. For information about viewing other TLl record 
attributes or changing the order of the displayed attributes, refer to 
Section A. 13.1, TLl Console Rearrange Attributes Dialog. As a 
TLl Console user, you can start only one TLl Console window. 

For information about modifying the security roles, refer to 
Roles Tab. To start the TLl Console, from the NETSMART menu, 
select TLl Console. The TLl Console window displays. As soon as 
you open the TLl Console, the display of TLl events begins and 
scrolls automatically to display additional events. The TLl Console 
window displays a maximum of 1000 records at a time. 

Display TLl Messages 

The display can be started, stopped or paused by selecting Start, 
Stop or Pause from the Operations menu or by selecting one of the 
Start, Stop, or Pause tools from the toolbar. 

1 The TLl console starts with the default setting, which displays TLl 

messages. The server will start sending messages to the console. 
To add, remove, or rearrange the attributes to be displayed, use 
the Rearrange Attributes dialog. For more information, refer to 
Rearrange TLl Attributes. If the display was paused earlier by 
selecting the Pause button, the console will display the messages 
that were sent during the pause and will then start to display new 
messages. If the display was stopped earlier by selecting the Stop 
button, the new real-time messages will begin to display. The 
Start button becomes active only when the display has been 
paused or stopped. 

2 To pause the message display, select Pause from the Operations 

menu or click the Pause tool. This option pauses the display of 
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TLl events to the console. Internally, the messages are buffered 
for up to 1000 records; these records will be displayed when you 
select Start to restart the display. 
3 To stop display of any messages in the console, select Stop from the 
Operations menu or select the Stop tool in the toolbar. The 
server stops sending messages to the console. 

Rearrange TLl Attributes 

Adding, removing, or rearranging the attributes to be displayed 
in TLl Console is accomplished by using the Rearrange Attributes 
dialog. 

1 To open this dialog, select Rearrange Log Attributes from the View 

menu or click the Rearran... tool in the toolbar. The Rearrange 
Attributes dialog displays. 

2 To add an attribute to the Selected List, highlight the attribute in the 

selections beneath the Attribute List and then click the Add 
button. 

3 To remove an attribute from the Selected List, highlight the attribute 

in the Selected List and then click the Remove button. 

4 To add or remove all attributes, use the AddAll button or the 

Remove All button. TLl Msg is the default item in the Selected List 
and cannot be removed. 

5 To change the order of the attributes in the list, select an attribute 

and then click the Up button to move the attribute up in the list 
or the Down button to move the attribute down in the list. 

6 Click OK to save the settings and close this dialog or click Cancel to 

cancel all changes and close this dialog. 
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Filter TLl Messages 

Messages to be displayed in the TLl Console can be filtered 
using the Filter TLl Messages dialog. 



1 To open the Filter TLl Messages dialog, select Filter from the 
5 Operations menu in the TLl Console window or click the Filter 

tool in the toolbar. The following dialog displays. 

2 Messages can be filtered based on the NE TID or the message type. 

Select the filter from the A^jE' ID drop-down list. To filter the 
TLl message display based on the NE TID, select: 
10 Starts with— If you want the NE to start with the specified 

value. 

Ends With— If you want the NE to end with the specified value. 
Contains— If you want the NE to contain the specified value. 
Type the text relevant to your NE ID selection in the 
15 Value field (for example, FLM) and check the Case 

Sensitive box to search for the NE using the case-sensitivi- 
ty specified for the typed value. 

3 To filter messages based on the message type, in the Message Type 

screen area, select the message type(s) that you want to be 
20 displayed in the TLl Console window. The TLlSuperConsole 

user can filter all message types. The TLl Console user can only 
view and filter the following messages: Command, Response and 
Acknowledgement. The complete list of message types includes: 
Unparsed, Send Raw, Autonomous, Received Raw, Command, 
25 Acknowledgement, and Response. 

4 Click OK to make the changes and close the dialog or click Cancel 

to close the dialog without making any changes. 

App'n of Fujitsu Network Communications, Inc.: FN-3014 Page 106 



Reports 

This section provides the procedures for reporting information 
from the NETSMART databases. All the reports are similar in 
functionality and access methods. 

Link Report 

Use the Link Report window to view and edit physical link 
information in the NETSMART database. Read-only (view) functions 
include filtering and sorting of displayed physical links. Edit functions 
include modification of physical link names and deletion of physical 
links from the system. The Link Report can be displayed as either: 
« A global view (all physical links in the system) 
s A group link view (all physical links belonging to a particular link 

that is displayed on the Topology map window) 

NETSMART CrossConnect Report 

The CrossConnect Report dialog displays a report containing 
information about a selected type of crossconnect. 

1 In one of the Crossconnect tabs, select Report from the Operations 

menu or select the Report tool from the toolbar. In the cascade 
to the right of the Report menu label, select the type of 
crossconnect to report. The Crossconnect Report dialog (Figure 
33) displays. 

2 Use the tools on the toolbar or select Operations menu items to 

perform the following functions. 

* Select the Print tool to display the Print dialog to print a 

report. 

* Select the Filter tool to display the Filter dialog to filter the 
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information displayed. 
- Select the Sort tool to display the Sort dialog to sort the 

information displayed. 
^ Select the Columns tool to display the Column Settings dialog 

to determine the columns to be displayed. 
^ Select the Deselect tool to remove the selection shading from 

any selected screen area(s). The tool will be grayed out 

and unavailable if no selection has been made. 
^ Select the Reload tool to reload information from the 

NETSMART database. 
3 Once you have completed operations in this dialog, click Close to 
close the report. 

NETSMART CrossConnect Trail Report 

The CrossConnect Trail window displays a report containing 
information about all the crossconnects in all the NEs that are 
autodiscovered in the Topology window. 

1 Access this dialog by selecting Query NE from the Topology view 

Edit Menu. 

2 In the dialog, select CrossConnect Name from the choice box labeled 

Query by and type the CrossConnect name or another valid value 
in the adjoining text field. Wild card searches are allowed, so the 
entry can either be a name or part of a name followed by a % 
sign. A % sign can be entered alone, in which case all the 
crossconnects will be retrieved from the database. The text field 
cannot be left blank. Apostrophes cannot be used. The apostro- 
phe interferes with Oracle semantics. For either of the two cases, 
a popup dialog prompts you to enter a name or to refrain from 
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using an apostrophe in the search name. 

3 Click Ok to produce the report or click Cancel to cancel and close 
this dialog. 

4 The NETSMART CrossConnect Report window displays^ 

5 Use the tools on the toolbar or select Operations menu items to 

perform the following functions. 

i Select the Print tool or select Print from the Operations menu 
to display the Print dialog to print a report. 

i Select the Filter tool or select Filter from the Operations 
menu to display the Filter dialog to filter the information 
displayed. 

i Select the Sort tool or select Sort from the Operations menu 
to display the Sort dialog to sort the information dis- 
played. 

» Select the Columns tool or select Column Settings... from the 
Operations menu to display the Column Settings dialog to 
determine the columns to be displayed. 

« In a multipage report, use the Previous and Next tools to go 
to the previous and next page of the report. 

* Use the DelXC tool to delete a crossconnect. 

i Select the Deselect tool or select Deselect from the Operations 
menu to remove the selection shading from any selected 
screen area(s). The tool and the menu selection will be 
grayed out and unavailable if no selection has been made. 

# Select the Reload tool to reload information from the 

NETSMART database. 

6 When completing operations in this window, select Close from the 

File menu to close the report. 
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Delete a CrossConnect from the Trail Report 

A CrossConnect can be deleted from the NETSMART 
CrossConnect Trail Report. In the NETSMART CrossConnect Trail 
Report, each of the rows represents one crossconnect record. 
Crossconnects can be deleted from the NETSMART Crossconnect Trail 
Report by selecting the appropriate row(s). 

1 After the NETSMART Crossconnect Trail Report displays, select the 

row(s) to delete using the mouse. For multiple selections, you 
have two options: 

Hold down the SHIFT key and click on the desired rows to 

select a contiguous set of records. 
5 Hold down the CTRL key and click on the desired rows to 

select a non contiguous set of records. 

2 Either select the tool labeled DelXC from the toolbar, or from the 

Operations menu select Crossconnect. From the Crossconnect 
runoff menu, select Delete XC. 

3 Once the row(s) have been selected from the table in the report 

panel, select either the tool labeled DelXC, or from the Opera- 
tions menu select Crossconnect and from the runoff menu select 
Delete XC. Some of the crossconnects may be redlined. If so, 
when the Ok button is clicked on the Confirmation dialog, an 
Information Message box indicates that some of the 
crossconnects selected could be set to redline, and asks whether 
you would like to delete the Crossconnects not redlined and skip 
the redlined ones. If the Y (Yes) option is selected, the 
unredlined crossconnects are deleted. If (No) is selected, 
control is remrned to the table in the Report from where the 
selections were made. If Yes was selected, the report will 
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redisplay without the deleted crossconnect. If 7 (Yes) is selected, 
the crossconnects should be deleted. However, there could be 
reasons for which the delete operation for a few crossconnects 
might fail. In that case a dialog provides a list of failed 
5 crossconnect deletes and the reason why that delete from the 

report failed. 

4 To verify that the changes have been made, select Report from the 
Operations menu, then select the appropriate type of 
crossconnect. A report is displayed showing all the selected types 
10 of crossconnects. 

Printing 

This section describes the procedures associated with printing 
NETSMART information. This information includes: 
^ Printing a report 
15 Saving a report to a disk 
i Printing a graphical view 
^ Selecting a table area for printing 

Previewing print output 
^ Setting up a page for printing 

20 Printing Overview 

Use the NETSMART Print dialog to enter print commands and 
to print reports to a file or to a printer. The following describes page 
layout and wrapping: 

^ By default, if a row is wider than a page, the data is wrapped inside 
25 the cell. 

^ Table rows are wrapped into multiple table regions, but only one 
table region is printed on each page, regardless of how many 
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table regions can fit into one page. Table rows that extend 
beyond a single page are broken into side-by-side pages on cell 
boundaries 

^ A Fit Page Width button is provided in the Page Setup dialog. When 
this button is selected, regardless of how wide a table row is, the 
table width is set to the same as the page width. 
Note: A maximum of 100 lines of output is produced for each 
report. 

Print a Report 

1 After displaying a tabular report, print the data by selecting either 

the Print option on the File menu or by selecting the Print tool 
from the toolbar. The Print option on the File menu is not 
always available. The NETSMART Print dialog displays. 

2 Select or type values in the following fields: 

Print To— Select the output format: Printer, Text File, or 
PostScript File. 

Printer Command:— For text/postscript file output, this field 
will be grayed-out and unavailable. For printed output, 
type any valid printer command(s) in this field. 

File Name:— If you are printing to a file, use this field to type 
a file name. 

Orientation— For printer output, select whether the printed 
output should be in landscape or portrait format. 

Paper Size— For printer output, select the size of paper for the 
printed report. 

3 Use the Preview... button to display a print preview. 

4 Use the Setup.,, button to set up printing parameters. 

5 Click Ok to send the data to the specified output device. 
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6 Click Apply to apply the changes and leave the dialog open. 

7 Click Cancel to close the dialog without sending the data to the 

output device. 

Save a Report to a Disk 

Certain tabular style reports can be saved to a disk in text file 
(.txt) or PostScript (.ps) format. 

1 After displaying a tabular report, click the Print tool or select the 

Print Table option from the File menu. The NETSMART Print 
dialog displays. 

2 Select or type values in the following fields: 

Print To— Select one of Text Ft le or PostScript File. 

Printer Command:— For text/postscript file output, this field 

will be grayed-out and unavailable. 
File Name: — Type the name of the file to be created. Click on 

the button to the right of this field to display the File 

Selection dialog where you can select a location for the 

file. 

Orientation — This field is grayed out and not available for 

text/postscript file output. 
Paper Size — This field is grayed out and not available for 

text/postscript file output. 

3 Use the Preview... button to display a print preview. 

4 Use the Setup... button to set up printing parameters. 

5 Click Ok to save the data to the specified location. 

6 Click Apply to apply the changes and leave the dialog open. 

7 Click Cancel to close the dialog without saving any data. 

Print a Graphical View 
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The Print View option on the File menu lets you print what you 
see on the screen. This option is available in components that have 
graphic images (such as Topology). It is also enabled in some 
components that produce reports. If this selection is not available, it is 
grayed-out. 

1 After displaying a graphical view, print the view by selecting the 

Print View option on the File menu. The NETSMART Print 
dialogs 

2 Select or type values in the following fields: 

Print To— Select the output format: Printer, Text File or 
PostScript File. 

Printer Command:— For text/postscript file output, this field 
will be grayed-out and unavailable. For printed output, 
type any valid printer command(s) in this field. 

File Name:— If you are printing to a file, use this field to type 
a file name. 

Orientation— For printer output, select whether the printed 
output should be in landscape or portrait format. 

Paper Size— For printer output, select the size of paper for the 
printed report. 

3 Use the Preview.., button to display a print preview, 

4 Use the Setup... button to set up printing parameters. 

5 Click Ok to send the data to the specified output device. 

6 Click Apply to apply the changes and leave the dialog open. 

7 Click Cancel to close the dialog without sending the data to the 
output device. 

Print Area 
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Use the Print Area option on the File menu to select an area of 
a table for printing. Both Set Print Area and Clear Print Area options 
may be available. The Print Area option is only available for tables. 

1 Display the table that you want to print. Select Print Area from the 

File menu, and select Set Print Area from the Print Area menu. 

2 Select a row or rows for printing. For multiple print elections, you 

have two options: 

t Hold down the SHIFT key and click on the desired rows to 
select a contiguous set of records. 

Si Hold down the CTRL key and click on the desired rows to 
select a non-contiguous set of records. When you select an 
area for printing, no visual changes occur. 

3 Click on the File menu, then select the Print menu item. 

4 Process printing as normal. When printing, only the selected region 

is taken into account. For example, the Print Preview option will 
show only the selected region. The Clear Print Area option will 
clear the selected area. . 

Print Preview 

Use the Print Preview option on the File menu to view what will 
be sent to the printer or file. The Print Preview option is available for 
any tabular data displayed on the screen. 

Note: A maximum of 100 lines of tabular output is produced for 

each report. 

1 After displaying a report with the appropriate data, select the Print 
Preview option from the File menu. The NETSMART Print 
Preview dialog displays. 
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2 Select the Print button to display the Print dialog. 

3 Click the Close button to close the Print Preview dialog. 

NETSMART Page Setup 

Each Print dialog in NETSMART contains a Setup,,, button. 
5 Selecting this button displays a dialog where you can select parameters 
that affect printed output. 

1 After displaying a report with the appropriate data, select the Print 
tool from the toolbar or cUck on one of the print options on the 
File menu. The NETSMART Print dialog displays. 
10 2 Click to select the Setup,., button. The NETSMART Page Setup 
dialog displays. 

3 In the Font area in this dialog, click in the selection list to the right 

of the Name label and select the font name to be used for 
printing. In the selection list to the right of the Style label, select 
15 the font style to be used for printing. In the selection list to the 

right of the Size label, select the font size to be used for printing. 

4 In the Title field, either select the default window title or type a new 

value that will be the title for the print output. 

5 In the Header field, type a value that will be used as the header 
20 information for the print output. 

6 In the Footer field, type a value that will be used as the footer 

information for the print output. 

7 Check the Fit Page Width box to fit the print output within the page 
width. 

25 8 Click Ok to send the output to the selected printer. 

9 Click Apply to make the changes but keep this dialog open. 

10 Click Cancel to close the dialog without printing. 
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Filtering Tabular Information 

Use the Filter tool and/or select Filter from the Operations menu 
to refine the data that you want to see in a report or other tabular 
information. Many of the reports in NETSMART provide this option 
including the Log Manager and Fault Manager reports. 

1 After displaying a report with the appropriate data, select the Filter 

tool from the toolbar or, if it is available, select the Filter option 
from the Operations menu. The Filter dialog displays. 

2 Click on a button beneath the Field label to display a drop-down list 

to select a field. 

3 Select a field to be filtered. The Test button becomes active. Click on 

this button to display a series of values to test against for 
filtering, one of: 
^ contains 
Icontains 
^ starts with 
^ /starts with 
^ ends with 
lends with 
Click to select one of these values. 

4 Use Boolean values to filter by selecting one of AND / OR from the 

choice boxes beneath the Logic button. 

5 Once all filtering values are selected, click Ok to redisplay the 

information with the filter (s) applied. 

Sorting Information 

Use the Sort dialog to specify sorting criteria in most tabular 

views. 
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Note: There are two types of Sort dialogs. One type allows you 
to sort using a single argument, while another type (the Fault 
Manager, for instance) allows selection of multiple sort argu- 
ments. In the second type (multiple arguments), it may sometimes 
5 appear that the data is not ordered correctly. . 

1 Click on the Sort tool or select Sort from the Operations menu. The 

Sort dialog displays. 

2 The sert will consider case on string sorts. To turn off case-sensitivi- 

ty, select the Ignore Case? (valid only for strings) box at the top 
10 of the dialog. 

3 Select the sort parameters. The order in which you select the Sort By 

buttons will determine the sort order. 

4 Use the Order button to indicate the sort order for the Sort By 

parameters. Select one of Ascending (lowest to highest) or 
15 Descending (highest to lowest). 

5 Click Ok to begin the sort. The data will redisplay in the sort order 

that you specified. 

Sorting by Time 

In a tabular display, where data can be sorted on multiple 
20 criteria, the results of a sort may appear erroneous because the system 
measures time in milliseconds, while NETSMART reports time in 
seconds. For example, the following Sort dialog shows the sorting 
criteria that were used to sort Fault Manager alarms information. First, 
the time the alarm was raised was selected and then the severity of the 
25 alarm was selected. The resulting output looks to be incorrect for the 
10:31:44 time slot. The results of the sort in the following figure shows 
that a condition (NA) is inserted between two major alarms. The 
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condition was raised milliseconds before the second major alarm, so it 
appears in the list before the second major alarm. 



Ordering Sort Parameters 

The order in which the Sort By buttons are selected will 
5 determine the sort order. The first (top) sort parameter has precedence 
over the second, the second has precedence over the third, and so 
forth. When the sort takes place, the NMS Raise Time will be sorted 
first. Because the Ascending button wasselected, the sort will be from 
the earliest time to the most recent time. Next, the severity level of 
10 each alarm will be sorted in descending order within each NMS raise 
time. Alarm conditions will be sorted next in descending order within 
each severity level (which was sorted within each NMS raise time). 
Service Effect is the last button selected, and will be sorted last. 
Because the Ascending button is selected, the processing will sort 

15 service effects in ascending order, within each condition. 

\^ 

Cutting and Pasting Information 

O 

in Support for Copy and Paste is available in editable fields such as 

the ones in Edit NE and the Raw TLl editor, using the system 
clipboard. 

20 Use CTRL+C to copy the information, and CTRL+V to paste it into 
a text area. From tables, right clicking on a cell lets you see the text 
in a separate dialog. Select the text in this dialog that you want to copy 
and press CTRL+C to copy. The text can then be pasted by pressing 
CTRL+V in a text destination field. There is no menu item or toolbar 
25 tool to support this action. 



i-1 



Setting Column Displays 
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You can define which columns will be displayed and which will 
be hidden in most tabular views. To display the Column Settings 
dialog, either click on the Columns tool in the toolbar or select Column 
Settings from the Operations menu. Use the Column Settings dialog to 
specify display criteria. The order for column display can be changed 
by selecting the heading field and dragging the field to a different 
position in the display. 

1 Click on the Columns tool or select Column Settings from the 

Operations menu. The Column Settings dialog displays. 

2 By default, all columns are listed in the Visible Columns list. Click 

to select a column in the Visible Columns list and then select the 
Hide button to move the column to the Hidden Columns list. To 
show a hidden column, click to select a column in the Hidden 
Columns list and then select the Show button to move the column 
to the Visible Columns list. 

3 Highlight a visible column and then use the Move Up or Move Down 

button to move the order of the column in the list. This will 
change the display order for the columns. 

4 Click Ok to confirm the column settings. 

View Log s 

Use the Log Managers to view NETSMART logs. Available logs 
include: 

^ Activity Log Manager 
* Fault Manager 
^ TLl Log Manager 

^ Transient Event Log Manager Each of these logs can be viewed 
from the NETSMART menu's Log Manager selection. All logs 
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maintain a maximum of 30 days worth of records. 
Note: There are two types of Sort dialogs. One type allows you 
to sort using a single argument, while another type (the Fault 
Manager, for instance) allows you to select multiple sort 
5 arguments. In the second type (multiple arguments), it may 

sometimes appear that the data is not ordered correctly. 

View Activity Log 

Tlie Activity Log provides a summary list of operator activities 
and NE state changes. For performance reasons, the Activity Log is 

10 buffered and the user may experience a delay of at least 1 minute 
before the log appears in the database. This delay is to accommodate 
transient log messages. The Activity Log is sorted based on a descend- 
ing timestamp order. The record with the newest timestamp is 
displayed first. Because the system measures time in milliseconds while 

15 NETSMART reports time in seconds, some sort ordering may appear 
erroneous. 

1 From the NETSMART menu, select Log Managers. From the menu, 
select Activity Log Manager to display the Activity Log Manager 
window. The selected log displays. By default, the Activity log 
is sorted in Timestamp Descending order. 
Note: It takes approximately 30 seconds to 1 minute for an action 
to be added to the Activity Log. 

View Fault History Log 

Once an NE alarm has been cleared, the record is stored in the 
25 Fault History database. For performance reasons, the Fault History 
Log is buffered and the user may experience a delay of at least 1 



20 



App'n of Fujitsu Network Communications, Inc.: FN-3014 



Page 121 



minute before the log appears in the database. This delay is to 
accommodate transient log messages. 

1 From the NETSMART menu, select Log Managers. From the 
cascading menu to the right of Log Managers select the Fault 
5 History Log Manager. The following window displays. The 

menu bar and toolbar for the Fault History Log Manager are 
identical to the Activity Log Manager. 

View TLl Commands 

Both user-generated and NE-originated TLl commands can be 
10 viewed in the TLl Log. 

1 From the NETSMART menu, select Log Managers. From the 
cascading menu to the right of Log Managers select TLl Log 
Manager. 

View Transient Events 

15 The Transient Log Manager allows viewing, filtering and sorting 

of all the Transient Condition events from the Fault History log. 
Transient Condition records are those that are reported but do not have 
any clearing event associated with them. It is similar to the Fault 
History log manager except for the condition that is a Transient event. 

20 For performa:nce reasons, the Transient Event Log report is buffered 
and the user may experience a delay of at least one minute before the 
log appears in the database. 

1 From the NETSMART menu, select Log Managers. From the 
cascading menu to the right of Log Managers select Transient 
25 Log Manager. The toolbar and menu bar arc the same the 
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Activity Manager. 
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Introduction to Meta Model 

This section provides overview and design information about 
Meta Model component of NETSMART. The Meta Model provides an 
instantiated means of describing any specific network element and 
5 generic. The meta model captures the physical and logical components 
that comprise the NE. 

This meta model is used by the application to access meta 
information for an NE and any specific instance of a component 
supported by the NE. One challenge and objective for NETSMART is 
10 to provide a generic solution for introducing new NE assemblies. The 
design of the meta model was intended to satisfy this goal. Other 
applications within NETSMART also face this similar challenge. 

It is been widely accepted that a network element suites a generic 
assembly tree pattern very well. Ideally, applications like auto 
15 discovery, auditing, reconciliation, database change handling, configu- 
ration management should all provide generic solutions (i.e. non-type 
specific). Type specific traversal is supported by the meta model for 
those applications that find it difficult to design generically. 

Scope 

20 This document describes the NE Meta Model design with some 

coverage on related applications (e.g. Autodiscovery). It does not cover 
details on aspects related to other components. It is acknowledged that 
additional requirements for the Meta Model will arise during the 
remaining development phases of NETSMART. The NE Meta Model 

25 is very flexible and extensible. It is expected that as additional 
requirements are identified they will be added to subsequent revisions 
of this document. 
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Overview 

This section provides an overview for the Meta Model compo- 
nent of NETSMART. Meta Model is the core the data driven approach 
of NETSMART. Various semantic details of a network element are 
5 captured in Meta Model, such as different objects managed by network 
element (e.g shelves, equipment, facilities etc.), relationships between 
these objects, various attribute applicable to these managed objects etc. 
The containment hierarchies between managed objects is also captured 
in Meta Model. The meta model provides a type of management 
10 information base for the application. If something changes between two 
successive releases of a network element, it can be handled in Meta 
Model by just incorporating these changes to the network element 
model. Following are few examples of the kind of information captured 
in in this component: 

;^ 15 • Equipment contained in a shelf 
in • Different facilities available on a network element. 

Iq • Different values which an equipment attribute can take 

• Working and Protect participant in an EPG or FFP 



O 



The following depict the major design objectives for the meta model. 
20 • Easy introduction of new network elements. 

• Allow the applications to traverse the meta model hierarchically and 
generically. 

• Allow the applications to define various data model, and meta 

model, relationships which will help satisfy their specific 
25 requirements. Note: These may and probably will be unrelated 

to the assembly containment. For example, a MetaSection is a 
way to group MetaSlot(s) for alarm correlation but a 
MetaSection has nothing to do with the assembly hierarchy. 
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Provide the application with the ability to design using typed 
interfaces while maintaining the models generically. 
Each managed object on network element is represented by a 
Meta Object in the Meta Model which contains all relevant meta 
5 information about that managed object. There are different Meta 
Objects for different type of facilities, equipment, EPGs etc. Each 
Meta Object for a given NE type in the meta model, is identified by 
Meta Instance Id which is just a label given to Meta Objects for 
identification. If there are multiple Meta Objects of the same type (e.g. 
10 two STSl facilities) which have same characteristics, they are mapped 
to the same Meta Component. Meta Component represents 'Type' of 
Meta Object. The attributes can be defined against a Meta Object as 
well as Meta Component. Attributes defined against a Meta Component 
are applicable to all Meta Objects related to that Meta Component. All 
15 common attributes of similar Meta Objects are defined against Meta 
Component whereas, if there are any specific attributes applicable to 
a particular Meta Object only, they can be defined against Meta Object 
itself. Meta Model also captures some information which does not 
pertain to network element directly, for example the name of the java 
iU 20 class to be used for address translation for a particular NE is also 
captured in meta model. 

In the overall picture of NETSMART, meta model resides in 
Application Server. Configuration Manager is the main user of meta 
model. All other components access meta model via Configuration 
25 Manager. The usage of meta model can be divided into two major 
parts: 

• Autodiscovery/Resync/ Audit/Reconcile 

• Providing specific meta information 
The meta model knows nothing about the current state of a 
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network element. It maintains only a static representation of a network 
element. The Autodiscovery^ application uses the meta model to drive 
the building of the dynamic view of the network element. Only the 
dynamic view of a network element provides current state. The 
dynamic view of a network element is captured in another component 
namely the Configuration Manager. Fundamentally, the dynamic view 
of a network element is a subset of the meta model containment tree. 
During autodiscovery, the containment hierarchy modeled in meta 
model is used to build the containment tree (dynamic view) of 
application objects in Configuration Manager. The containment 
hierarchy in meta model dictates the containment hierarchy in configu- 
ration manager. Only containment relationships in meta model are used 
for autodiscovery. Other relationships in the meta model relationship 
tree are not used during autodiscovery. 

Once autodiscovery is done, configuration manager can obtain 
any specific meta information from meta model. For example, while 
displaying equipment and ports in configuration manager GUI, 
configuration manager needs to find out various ports supported by a 
particular equipment. This information is obtained by configuration 
manager from meta model on need basis. Another example is that when 
user wants to change some provisioning attribute on a facility or 
equipment, configuration manager GUI presents list of valid values for 
that attribute. This list of valid values is obtained from meta model on 
need basis. 

Meta Model can be divided into two parts on broad basis: 
• Meta Model Data 



^ Autodiscovery is the process of obtaining configuration informa- 
tion from NE and persisting in Configuration Manager. 
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• Meta Model Engine 

Meta Model data contains all the static modeling information 
about the network element. It models all the Meta Objects, relation- 
ships between them, various applicable attributes on Meta Objects, 
5 valid values for these attributes etc. This data is captured in oracle 
database tables as per the data model. Initially, this data is recorded in 
.db files, one corresponding to each table in data model. These .db 
files are loaded into oracle database using some awk scripts during 
NETSMART installation. Once this data is loaded into oracle data- 

10 base, during Application server startup this information is read by Meta 
Model engine and cached in memory in form of relationship tree. Once 
loaded into memory, Meta Model engine uses this cache for future 
refer-ence. It is possible to delay loading of this information into 
memory Meta Model engine is the executable part in meta model which 

15 implements all the interfaces exposed. It also implements semantic 
interpretation of Meta Model data, loading of meta model data from 
database to memory. 

Feature Dependencies 

In order to be able to support autodiscovery, Meta Model is 
20 dependent on support from COMMS for that NE type. 

Process Overview 

This section addresses process of adding support for a new 
network element assembly. Following are main steps involved in 
supporting new network element in netsmart from meta-model point of 
25 view: 

• Understanding the network element : This involves reading the 

documentation (e.g. Architecture and design documents, TLl 
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document etc.) available on network element to be supported. 
This helps build the general understanding of the network 
element. This also involves trying TLl commands on the NE 
and/or interacting with NE people to clarify some behavioral 
5 doubts. 

• Modeling meta objects and relations : This involves abstracting the 

containment and other relation-ships between various objects to 
be modeled. Various relationships and objects to be supported 
depends on the NETSMART requirements. NETSMART RSA 

10 dictates the type and level of support required in NETSMART 

for a network element. Please refer to Appendix A for list of 
various objects and relationships commonly modeled for network 
assemblies. It may be required to modeled additional relation- 
ships or objects depending on the requirements defined by RSA. 

15 This object-relation-ship model is captured in meta_assembly.db 

file. 

• Modeling other characteristics of meta objects: This includes filling 

up other. db files for support of network element in question. 
This include s meta_instance . db , meta_component . db , 
20 meta_property . db , meta_attr ibute . db , meta_attr_map , 

meta_collapsed_naming_key and meta_eqpt_type_map. 

• Implementing a data cache java class for fetching configuration 

information from network element during the process of 
Autodiscovery. 
25 • Testing autodiscovery for the network element. 

• Code review for the model. 

Assumptions 

Modeling of a new NE assembly assumes that the documentation 



App'n of Fujitsu Network Communications, Inc.: FN- 301 4 



Page 129 



for the network element is available (e.g. NMIS, PDS etc). Also, it is 
assumed for modeling of new assemblies that access to network 
element is also available. 

Data Model 

5 This section defines the data model which is used to instantiate 

the meta model. The assemblies for all net- work element types 
supported by NETSMART will be stored in the database (Oracle). A 
specific NE meta model can be loaded into memory on demand or pre- 
loaded during the Application Server initialization. SQL queries are 

10 used to retrieve the assembly data and instantiate the meta model. The 
data model has been updated for the 2.i release. Changes for 2.i 
included (a) adding newer columns to existing tables (b) dropping 
columns which existed prior to 2.i and (c) introducing new tables. 
Table and column definitions which existed prior to 2.i are mentioned 

15 in italics. This is expected to serve as a reference for developers. 

The following sections describe the data model and how the meta 
model uses it to instantiate a network element assembly: 

• Schema definition 

• Query model. 

20 Schema definition 

The following tables are used to define all network element assemblies 
which are managed by NETSMART. The meta model is built by 
querying the following tables: 

• metacomponent 
25 • meta_instance 

• meta_assembly 

• meta class 
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• metajproperty 
meta_attribute 

• meta_assembly_map 

• meta_collapsed_naming_keys 

• meta_attrjnap 

• meta_eqpt_type_map 

The following tables have been eliminated in 2.i: 

• meta_revision 

metacomponent 

The Component table is the catalogue of all available part types 
for a network element. Each part for a given base network element 
(e.g. FACTR) is assigned an component identifier that is a unique 
primary key to the Component table. Following table lists the different 
columns in the table and their descriptions: 

Table Column Datatype Description 

NE_BASE varchar2(32) The base network element 

identifier (e.g. FACTR). 

META_COMP_ID varchar2(32) A unique component 
identifier. 

APPL_CLASS varchar2(75) The name of the Java class used 

to create application object 
during autodiscovery. 
META_CLASS_ID varchar2(32) An enumerated meta class 

identifier. This field 
references the 
meta class table. 
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APPLICATI<aMcHB]t2R!E5) The type value used by the application 

for this component, 
(e.g. EQPT, TP, etc.). 

COMM^^TYPE varchar2(15) The type value used by the 

communications layer for this 
component, (e.g. EQPT, TP, 
etc.) There is not a one to one 
mapping with the APPLICA- 
TION__TYPE. 

NAMING_KEY varchar2(15) Some components have a naming 

key. It is analogous to the appli- 
cations ComponentType in the 
Relative-ComponentID . (e.g. 
Shelf, Slot, Group, etc.). Any 
given instance of this component 
may provide a NAM- 
ING_VALUE which is used in 
combination with this naming 
key. 

Constraints: 

• Primary key : NE_BASE, META_COMPJD 

• Foreign key: MET ACL ASSID references 
meta_class(meta_class_id) 

metainstance 

The Instance table is the inventory of all available parts. An 
instance refers to the particular existence of a component (MetaObject) 
in relationship tree identified uniquely by META_INST_ID for a 
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particular NE type. 



Table Column 

NE BASE 



Datatype Description 

varchar2(32) The base network element identi- 
fier (e.g. FACTR). 



METAJNSTID varchar2(32) 
for a specific component. 
METACOMPJD varchar2(32) 
identifier. 

NAMING_VALUE varchar2(32) 
Component ID for the meta object. 
INSTANCE TYPE varchar2(15) 



A unique instance identifier 
This instance's component 
Specifies complete 



AUTO CREATE a varchar2(16) 



Indicates if instance is a 
standard MetaObject, a 
collapsed MetaObject or 
an expandable collapsed 
MetaObject. 

Indicates when an instance 
gets created. 
case-1: when the configuration permits 
it 

case-2: always created automatically 
case-3: created by default if no data 
object exists 



a. This information is used by Autodiscovery service. Refer to 
Appendix I: for details. 
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Constraints: 

Primary key: NE BASE, META INST ID 

• NE BASE.META COMP ID references 
meta_component(NE_BASE, META COMPJD 

5 • instance_type can be in ('single', 'expand', 'collapse') 

• auto_create can be in ('normal', 'auto_create', 'default_create') 

metaassembly 

The assembly table describes the complete hierarchical composi- 
tion of a network element assembly. The composition is based on 
10 instance identifiers. The composition of an assembly uses named 
relationships (or edges) with possible conditional expressions. 

Table Column Datatype Description 

NEBASE varchar2(32) The base network element 

identifier (e.g. FACTR). 
15 PARENT varchar2(32) A instance identifier for a specif- 



25 



20 



ic assembly component. This 
instance of a component is the 
direct predecessor to the corre- 
sponding NODE identifier in the 
assembly hierarchy. NODE 
varchar2(32) A instance identifi- 
er for a specific assembly com- 
ponent. This NODE identifier is 
the successor to the PARENT 
identifier. 



EDGE 



varchar2(32) 



The EDGE defines a named 
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relationship between the PAR- 
ENT and the NODE. The rea- 
sons and usage of relationships is 
dependent upon application 
usage. For instance the 
Autodiscovery application is 
primarily concerned with CON- 
TAINMENT type relationships. 
Refer to appendix A for various 
relationships modeled in meta 
model. 

PRIORITY integer This determines the order in 

which rows are returned from 
database at the time of loading 
meta model into application 
memory. 

CONDITION varchar2(1024) The condition is an optional 

expression which can be attached to an 

edge . 
The 
dynam- 
ic eval- 
uation 
of the 
condi- 
tional 
expres- 
s i o n 
must 
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b e 
evalu- 
ated to 
true in 

5 order 

for the 
rela- 
tion- 
ship 

10 be- 
tween 
t h e 
PAR- 
ENT 

15 and the 

NODE 
t o 
hold. 



Constraints: 

20 • Primary key: NE_BASE, PARENT, NODE, EDGE 

• Foreign key: (NEBASE, PARENT) references 
meta_instance(NE_BASE, META INST ID) 

• Foreign key: (NEBASE, NODE) references 
meta_instance(NE_BASE, META INST ID) 

25 • EDGE must be one of ('IS A', 'IS A DEFAULT', 'CONTAINS', 
'CONTAINS_ONE_OF','CONTAINS_ONE_OF_DEFAULT', 
'CONTAINSFORNAMING' ,'CONTAINS_AS_WORKING' , 
'CONTAINS AS WORKING DEFAULT', 'CON- 
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TAINS_FOR_PROTECTING' , 'IS_NAMED_B Y' , 'SUP- 
PORTS_PORT', 
'SectionToEquipment' , 'SectionEquipmentDefault', 
'SectionToType', 'HAS_PROT_PARTICIPANT' , 
'HAS_PROTECTING_PARTICIPANT', 
'HAS_WORKING_PARTICIPANT' , 'IS_SUPPORTED_B Y' , 
'IS_XCONNECTABLE_TO', 
'IS_DEFAULT_XCONNECTABLE_TO', 
'IS_DEFAULT_lWAY_XCONNECTABLE_TO' 

metaclass 

The meta_class table provides the information needed to 
instantiate MetaObject(s). MetaObject(s) are the instantiated representa- 
tion of a component instance. The MetaObject models static informa- 
tion about a component. The MetaObject(s) are sub-classed (e.g. 
MetaShelf, MetaFunctionalGroup, MetaEquipment, etc.) and provide 
a typed hierarchical representation of an assembly. 

Table Column Datatype Description 

META CLASSJD varchar2(32) An enumerated meta class 

identifier. 

META_CLASS varchar2(75) The actual JAVA class name, 

including package information. 
These classes are implemented in 
the meta_model package and are 
instantiated using JAVA reflec- 
tion. 

metaassemblymap 
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The meta_assembly_map defines the assemblies managed by 
FENICS. It also provides for the mapping of assembly id. That is, a 
particular assembly can be managed as another. In addition, this table 
provides the weight assigned to a particular assembly, the managed 
5 level and auto load flag. 

Table Column Datatype Description. 

TYPE varchar2(32) The network element type 

as retrieved from the NE 
(e.g. FACTR). The com- 
10 plete assembly id consists 

of the TYPE, CONF, 

0 MAJOR, and MINOR 

fields (e.g. FACTR UPSR 

1 05 02). 

Fi 15 TO TYPE varchar2(32) Mapped network element type. 

MINMAJOR varchar2(5) The major and minor 

network element revision 
I number 
i| AUTOLOAD varchar2(5) Flag indicating whether the 

13 20 mapped assembly should be auto 

'3 loaded during initialization. 

The following are not available in 2.i: 

CONF The network element configuration as 

retrieved from the NE (e.g. UPSR). 
25 MAJOR The network element major revision as 

retrieved from the NE (e.g. 05). 

MINOR The network element minor revision as 

retrieved from the NE (e.g. 02). 



xf%. 
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TO BASE 



TOMAJOR 

TOJilNOR 

WEIGHT 
MANAGELEVEL 

Constraints: 

• Primary key: 

• AUTO^LOAD must be either 'true' or 'false' 

metaproperty 

The meta_j)roperty table captures the properties^ for a specific 
component. A property is a generic way of grouping attributes of a 
component. The grouping of attributes into properties is application 



^ Properties can be visualized as category of attributes. There are 
various categories of attributes modeled in meta model e.g. TLl related 
attributes, attributes required to control behavior of other components 
etc. 



Map the above assembly to this base 
network element id. (e.g. FACTR). The 
mapped assembly id consists of the 
TO BASE, TO MAJOR and 
TO MINOR fields (e.g. FACTR 05 02). 
Map the above assembly to this 
major network element revision, 
(e.g. 05) 

Map the above assembly to this 
minor network element revision, 
(e.g. 02) 

The weight assigned to the complete 
assembly id. 

The managed level of the 
mapped assembly id (e.g. 5S) 
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dependent. For example, the attributes which are used to describe a 
components current state and configuration are grouped into the 
ATTR LIST property. 

Table Column Datatype Description 

NE BASE varchar2(32) The base network element 

identifier (e.g. FACTR). 
META PROPERTY ID varchar2(32) Unique identifier for 
the property. 

PROPERTY_NAME varchar2(32) The name assigned to 

this property, (e.g. ATTR LIST) 

The following are not available in 2.i 

META COMP ID The component identifier 

which is associated with 
this property. This may 
also be a 
META_CLASS_ID. If it is 
a META_CLASS_ID, all 
instances of the particular 
META CLASS receive this 
property. 

PROPERTYKEY A unique identifier for a property 

name. Used to distinguish identi- 
cal property names with condi- 
tions. 

CONDITION A condition expression 

which can optionally be 
attached to the property. 
The dynamic evaluation of 
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the conditional expression 
must be evaluated to true 
in order for the component 
to access this property. 

Constraints: 

• Primary key: NE_BASE, META_PROPERTY_ID 
metaattribute 

The meta_attribute table captures the attributes for a specific 
property. The meta attribute table provides the capability of describing 
the characteristics of any given attribute. This table serves as inventory 
of different attributes applicable to NE types. 

Table Column Datatype Description 

NE_BASE varchar2(32) The base network element 

identifier (e.g. FACTR). 
META ATTRIBUTE ID varchar2(32) Unique identifier for 
the attribute. 

PROPERTYJD varchar2(32) Prior to release 2.i, this 

column was called PROP- 
ERT Y_N AME . Together 
with NE BASE, referenc- 
es meta_property(ne_base, 
meta_property_id) 

ATTR NAME varchar2(32) The name assigned to this 

attribute. 

TYPE varchar2(10) The application type 

of the attribute. For 
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:J if 



in 



VALUE 



varchar2(256) 



10 



varchar2(20) 



DEFLT 

VALID_VALUES varray called 

for this attribute. This is 

str list t 



example, String, 
Integer, Boolean, 
Float, Enum. 
Although the data model, 
and meta model do not 
know the current state of 
any components attributes. 
Some attribute have a 
static value. This value is 
not expected to change. 
The default attribute value. 
A list of valid values 



15 



currently limited to 15 elements 
of maximum length 15. 



MIN 



varchar2(20) 



20 MAX 



varchar2(20) 



INCR 



varchar2(20) 



25 



READ ONLY 



varchar2(5) 



A minimum value 
for this attribute. 
Used for Integer 
and Float only. 
A maximum value 
for this attribute. 
Used for Integer 
and Float only. 
A increment value 
for this attribute. 
Used for Integer 
and Float only. 
A boolean flag indicating 
whether this attribute may 
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REQUIRED 



be changed or not. 
varchar2(5) A boolean flag 

indicating that this 
attribute is required. 



The following are not available in 2.i: 



=0 

in 

m 



PROPERTYKEY 



10 AJTRKEY 



META COMP ID 



15 



20 



CONDITION 



25 



A unique identifier for a property 
name. Used to distinguish identi- 
cal property names with condi- 
tions. 

A unique identifier for an attrib- 
ute name. Used to distinguish 
identical attribute name with 
conditions. 

The component identifier 
which is associated with 
this property. This may 
also be a 
META CLASSJD. If it is 
a META CLASSJD, all 
instances of the particular 
META CLASS receive this 
property. 

A condition expression 
which can optionally be 
attached to the attribute. 
The dynamic evaluation of 
the conditional expression 
must be evaluated to true 
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in order for the component 
to access this attribute. 



Constraints: 

• Primary key: NE BASE, META ATTRffiUTE ID 

• Foreign key: (NE BASE, META PROPERTY ID) references 

meta_property(NE_BASE, META PROPERTY ID) 

• ATTRNAME is NOT NULL 

• TYPE must be in ('String', 'Integer', 'Boolean', 'Float', 'Enum', 
'Class') 

• READ ONLY must be either in 'true' or 'false 

• Valid values for REQUIRED must be either 'true' or 'false' 

metaattrmap 

This table is new for the 2.i release. It links meta_attribute with 
either meta component or meta instance. 

Table Column Datatype Description 

NE BASE varchar2(32) The base network element 



METAATTRffiUTEID varchar2(32) Unique identifier 



identifier (e.g. FACTR). 



META ID 



varchar2(32) 



Identifies the 
metacomponent or 
meta instance to which the 
attribute is assigned. 



for the attribute. 



CONDITION 



An optional condition 
expression. The dynamic 
evaluation of the condi- 
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tional expression must be 
evaluated to true for the 
component instance to 
access this attribute. 

Constraints: 

• Primary key: NE_BASE, METAJD, META_ATTRIBUTE_ID 

• Foreign key: (NE_BASE, META_ATTRIBUTE_ID) references 

meta_attribute(NE_BASE, META_ATTRIBUTE_ID) 

• Foreign key: (NE_BASE, META ID) may reference either 

meta_instance(NE_BASE, METAINSTID) or 
meta_instance(NE_BASE, META_COMP_ID) 

metaeqpttypemap 

This table is new for release 2.i. contains a vendor ID/CLEI to 
equipment type mapping. 

Table Column Datatype Description 

NE BASE varchar2(32) The base network element identi- 

fier (e.g. FACTR). 
VENDOR_ID varchar2(32) Vendor Id (or CLEI) that 

uniquely identifies an 
equipment type. 

NEEQPTTYPE varchar2(32) Equipment type. This 

doesn't have to be unique 
since different vendor 
IDs/CLEI codes can map 
to the same equipment 
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type. 



Constraints: 

• Primary key: NE BASE, VENDOR ID 
metacoUapsednamingkeys 

This table is new for release 2.i. Specifies for a collapsed meta 
instance what are its naming keys that must be resolved. E.g. the 
collapsed object representing an ATM VC on the SONET ring, the 
unresolved naming key would be vci. 



ii ii 



10 



15 



20 



Table Column 

NEBASE 

META INST ID 



NAMING KEY varchar2(15) 



MIN 



MAX 



25 INC 



Datatype Description 

varchar2(32) The base network element identi- 
fier (e.g. FACTR). 
varchar2(32) Specifies a given instance. 

Together with NE_BASE, 
references 
meta_instance(ne_base, 
meta_inst_id) 
This is similar to the application 
ComponentType in the 
RelativeComponentID (e.g. 
Shelf, Slot, Group etc.). 
The minimum valid value for the 
RelativeComponen-tID . 
The maximum value for the 
RelativeComponentID . 
Incremental value for the 
RelativeComponentID 



integer 



integer 



integer 
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PREFIX 



varchar2(32) 



String that may have to be 
prepended to the Relative- 
ComponentlD. 



POSTFIX 



varchar2(32) 



String that may have to be ap- 
pended to the Relative- 
ComponentlD. 



PRIORITY 



integer 



A collapsed meta object may 
have multiple naming keys. This 
specifies the relative priority. 



INHERITED 



varchar2(5) 



Specifies whether value 
for RelativeComponentID 
is inherited from ancestor. 



Constraints 

• Foreign key: (NE_BASE, METAINSTID) references 

meta_instance(NE_NBASE, META_INST_ID) 

• INC should not be < 0 or > MAX 

• INHERITED must be either 'true' or 'false' 

• MAX should not be less than MIN 

metatmp 

This is a temporary table. It is used by Meta Model awhile 
populating its tables with data 

Table Column Datatype Description 

NAME varchar2(256) Used as a temporary work space 



during data load pro-cess. 



metastrings 
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Another temporary table. 



Table Column 



Datatype Description 

varchar2(700) Temporary 
integer Used to identify NAME 



NAME 



ID 



5 Constraints: 

• Primary key: NAME 

metarevision 

This table has been eliminated in release 2 A, 

The meta_revision table captures the possible revisions of 
10 components. Since network elements have revisions this table allows 
for the definition of the components which comprise a particular 
network element revision. Each network element revision must define 
a list of valid components which are used to define the assembly. 

Table Column Description 

15 NE BASE The base network element identifier (e.g. FACTE) . 

META COMP ID The component identifier. 
MJ REV The network element major revision which requires 



this component, (e.g. FACTR 05). This field is used 
in con-junction with the MN REV. 



20 



MN REV 



The network element minor revision which requires 
this component, (e.g. FACTR 05 02). This field is 
used in conjunction with the MJ REV. 



Query Model 

This section describes database queries performed by Meta 



App'n of Fujitsu Network Communications, Inc: FN-3014 



Page 148 



Model to instantiate a network element assem-bly. The following 
sections describe how the meta model is built: 

• Retrieving the Assembly Data 

• Retrieving an Assembly Base 

5 • Retrieving the Assembly Root Node 

• Retrieving the Assembly Hierarchy 

Each SQL statement and its corresponding result set are discussed 
below. 



in! 



Retrieving the Assembly Data 

10 SQL: 

SELECT * from meta_assembly_map; 



Results: 

The result is a collection of MetaAssemblyData objects. This collection 
of MetaAssemblyData define the net-work element assemblies which 
15 are managed by FENICS. This collection also provides a way to map 
a par-ticular assembly to another. That is, to manage a particular 
assembly as if it was another. For example, FACTR 05 02 may be 
is managed as a FACTR 05 01. Each MetaAssemblyData assigns a 

weight to a particu-lar assembly. In addition, the managed level and 
20 auto load flag is provided in the MetaAssemblyData. 

Retrieving an Assembly Base 

SQL: 

SELECT mi . meta_inst_id , mi . meta_comp_id , mi . naming_value , 
mc . appl_class , mc . meta_class_id , mc . application_type , mc . comm_type , 
25 mc.naming_key, mc.auto_create, ml.meta_class 
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FROM meta_instance mi, meta component mc, meta class ml 
WHERE mi.ne_base = :1 AND 

mc.nebase = mi.nebase AND mc.meta_comp_id = 
mi.meta_comp_id AND 
5 ml.metaclassid = mc.meta_class_id; 

Results: 

The result of this query is all of the components for a specified base 
assembly. This becomes a cache of Met-aNode( s) which is used by the 
individual assemblies under the base. 

10 Retrieving the Assembly Root Node 

SQL: 

SELECT mi.metainstid, mi.metacompid, mi.namingvalue, 
mc . applclass , mc . metaclassid , mc . applicationtype , mc . commtype , 
mc.naming key, mc.inherited_nk, mc.auto create, ml.meta class 
15 FROM meta instance mi, meta component mc, meta revision mr, 
meta class ml 

WHERE mi. meta_inst_id =:1 
AND mc.meta comp id = mi.meta comp id 
AND mc.ne base = mi.meta inst id 
20 AND mr.meta comp id = mi.meta comp id 
AND mr.ne base = mi.meta inst id 
AND mr.mj_rev = :2 
AND mr.mn_rev = :3 
AND ml.meta_class_id = mc.meta class id; 

25 Results: 

The result of this query is a particular revision of a network element 
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assembly. This is expected to return the single result set associated with 
a particular base, major and minor revision of an assembly. This result 
set is used to create the MetaNe root node in the assembly hierarchy. 

Retrieving the Assembly Hierarchy 

5 SQL: 

SELECT ma.ne base, ma.parent, ma. node, ma. edge, ma. condition 

FROM meta assembly ma, meta instance mi, meta revision mr 
WHERE ma.ne base =:1 AND 
ma.parent = :2 AND 
10 mi.ne_base = ma.ne_base AND 
y mi.meta_inst_id = ma. node AND 

\n mr.ne_base = ma.ne_base AND 

mr.meta_comp_id = mi.meta_comp_id AND 
jJI mr.nij_rev =:3 AND 

15 mr.mn_rev =:4; 

m Results: 

: 2 The result of this query are the successors to the specified parent and 

□ ne_base parameters. This SQL is recursively called in order to build 

'"^ the assembly hierarchy. It is started at the root MetaNe node and 

20 traverses depth first until it reaches leaf nodes and the entire tree is 

instantiated. NOTE: This is the most expensive, time consuming, part 

of building the meta model. 

Retrieving object-attribute assignment 

SQL: 

25 Please refer to LOAD ALL OBJECTS ATTR MAP inside 
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SELECT mi.meta inst id, mam.meta_attribute_id, mam. condition, 
ma . meta_property_id 

FROM meta instance mi, meta attr map mam, meta attribute ma 
5 WHERE mi.ne_base = :1 AND 

((mi.meta_inst_id = mam.meta_id) OR (mi.meta_comp_id = 
mam.meta_id)) AND 
mam.ne_base = mi.ne_base AND 
mam.meta_attribute_id = ma.meta_attribute_id AND 
10 ma.nebase = mi.nebase 

9 Results: 

Iji Loads all attribute_id values for every component inside an assembly. 

\n Retrieve a specific object in an assembly 

S SQL: 

15 Please refer to LOAD INSTANCE in MetaObjectLoader.java 

Q 

;"w SELECT mi.metainstid, mc.metacompid, mi.namingvalue, 

Q mc . appl_class , mc . meta_class_id , mc . application_type , mc . comm_type , 

~ mc.naming key, mi.auto create, mcl.meta class, mi.instance type 

FROM meta instance mi, meta component mc, meta class mcl 
20 WHERE mi.ne_base = :1 AND 

mi.meta_inst_id = :2 AND 

mi.meta_comp_id = mc.meta comp id AND 

mc.ne base = mi.ne base AND 

mc.meta class id = mcl.meta class id 
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Results: 

Loads a specific object in an assembly. 

Loading an Attribute for an assembly component 

SQL: 

Please refer to LOADOBJECTATTRIBUTES in 
MetaObjectLoader Java 

SELECT ma.ne_base, ma.meta_attribute_id, ma.meta_property_id, 
ma.attrName, ma. type, ma. value, ma.deflt, ma.valid_values, ma.min, 
ma.max, ma.inc, ma.read_only, ma.required, mam.condition 

FROM meta_instance mi, meta_attr_map mam, meta_attribute ma 
WHERE mi.ne base = :1 AND mi.metajnst id = :2 AND 
((mi.meta_inst_id = mam.metajd) OR (mi.meta_comp_id = 
mam.meta_id)) AND mam.ne_base = mi.ne_base AND 
mam.meta_attribute_id = ma.meta_attribute_id AND ma.ne_base = 
mi.ne_base 

Results: 

Loads all meta_attributes of a specified object in a given assembly for 
a particular network element. 

Loading specific object in an assembly 

SQL: 

Please refer to LOADJNSTANCE inside MetaObjectLoader.java 

SELECT mi.meta_inst_id, mc.meta_comp_id, mi.naming_value, 
mc . appl_class , mc . meta_class_id, mc . application_type , mc . comm_type , 
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mc.naming_key, mi.auto_create, mcl.meta_class, mi.instance_type 
FROM meta_instance mi, meta_component mc, meta_class mcl 
WHERE mi.ne_base = :1 AND. 
mi.meta_inst_id = :2 AND 
5 mi.meta_comp_id = mc.meta_comp_id AND 
mc.ne_base = mi.ne_base AND 
mc.meta_class_id = mcl.meta_class_id 

Results: 

Loads a specific meta_instance object by relating the meta_instance 
10 with meta_class and meta_component. 

Retrieve assembly for a network element 

SQL: 

Please refer to LOAD_ASSEMBLY in MetaObjectLoader.java 

SELECT parent, node, edge, condition, priority from meta_assembly 
15 WHERE ne_base = :1 ORDER BY parent, priority, node 

Results: 

Loads the ordered assembly data for a specific network element. 
Retrieving meta coUapsed naming keys 

SQL: 

20 Please refer to LOAD ALL COLLAPSED NAMING KEYS in 
MetaObjectLoader . j ava . 

SELECT * from meta_collapsed_naming_keys where ne_base = :1 
ORDER by priority; 
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Results: 

Loads information that will help to resolve naming_keys for a collapsed 
meta instance. 

Meta Model 

5 The MetaModelFactory is a singleton object which requires 

initialization in each process space that requires meta model access. 
The MetaModelFactory creates a MetaBaseAssembly for each base 
network element supported by the system (e.g. FACTR, FLM150, 
etc.). In addition, the MetaModelFactory assigns Meta Assembly (s) to 

10 each MetaBaseAssembly reflecting the network element revisons that 
are supported by NETSMART (e.g. FACTR 05 01, FACTR 05 02, 
FLM150 11 02, FLM150 12 02, etc.). Each MetaAssembly evaluates 
its auto load flag. If it is True, the MetaAssembly will initiate the 
instantiation of the assembly. The instantiation of the assembly starts 

15 at the MetaNe root node and instantiates a tree of MetaNode(s). The 
tree of MetaNode(s) include named relationships between nodes called 
MetaEdge(s). 

Each MetaEdge may have a condition expression which must be 
evaluated to true in order for the relationship to be valid. The 
20 instantiated assembly provides an application information base for a 
network element. It is static network element data that is used for 
autodiscovery, configuration management and various other application 
components. The assembly tree may be traversed generically or via a 
typed interface. 

25 If the auto load flag is False, the MetaNe root node is the only 

node that is instantiated. The rest of the assembly tree is instantiated on 
demand by the Application. The Application which requires access to 
an assembly obtains it via a MetaNeFactory. The Application 
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provides the necessary data to identify an assembly and acquires a 
MetaNe reference. If the assembly was not auto loaded it is loaded at 
this time. Figure 38 shows the MetaModel class diagram for this 
process. 

5 Meta Base Assembly 

The MetaBaseAssembly represents a base network element (e.g. 
FACTR).The MetaBaseAssembly is multithreaded and synchronized 
and is created during process initialization. MetaBaseAssembly has 
state which is represented by MBA State. At the time of initialization, 
10 the state is set to MBA Inactive. If Meta-BaseAssembly is auto load, 
a MetaBaseAssemblyLoader is created and the state gets transitioned 
y to MBA Loading. If it is not a case of auto load, then it is loaded on 

iiJ — 

m demand. The MetaBaseAssembly is only loaded once in the process 

space. If there is a second request to load a MetaBaseAssembly in 
in 15 MBA Loading state, the invoker is blocked until loading is complete. 
!g MBA NotFound represents absence of MetaBaseAssembly in 

;L, database. When the load is successful, the state is transitioned to 

m MBALoaded. 

j^J If load fails due to some reason, the state is transitioned to 

13 20 MBA Not Loaded. Figure 39 shows the MetaBase Assembly class 

diagram. Figure 40 shows the Meta Base Asembly state transition 

diagram. 

Meta Object 

The MetaNode is an abstration which allows for gener- 
25 ic/hierarchical traversal of a network element assembly. The MetaNe 
is the root MetaNode. The typed specific behavior is defined by the 
MetaObject subclasses. A MetaObject is a generalization of the things 
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that comprise a network element. The MetaObject may contain 
properties, or lists of attributes, called MetaProperty(s). The 
MetaProperty contains MetaAttribute(s). The MetaProperty and 
MetaAttribute may contain a Condition. The Condition must be 
evaluated at run time with context. Only if the Condition is true does 
the MetaObject recognize that MetaProperty or MetaAttribute. A 
MetaObject is created by the MetaReflector using Java reflection. The 
MetaObject is a abstract class used to define generic behavior for 
typed network element objects. The network element assembly is a 
generic tree pattern implemented by the MetaNode and MetaEdge 
relationships. The network element assembly is also typed. Each 
MetaNode is implemented as a MetaObject and subclass. Figure 41 
shows the MetaNode class diagram. 

Loading a meta assembly 

The network element assembly is a generic tree pattern imple- 
mented by the MetaNode and MetaEdge relationships. The network 
element assembly is also typed. Each MetaNode is implemented as a 
MetaObject and subclass. At the time of meta assembly loading, objects 
and relationships are retrieved from the meta_assembly database table 
and a relationship tree is constructed in application address space. 

Figure 42 depicts a small portion of a FACTR assembly. 
Starting at the root MetaNode (e.g. FACTR_5_2), the meta model is 
hierarchically built depth first. The root node contains a PHYSI- 
CAL_SIDE and a LOGICAL SIDE. From the PHYSICAL SIDE, the 
hierarchy continues by working its way down through the shelves, 
sections and equipments, etc. 

The hierarchy of the assembly is totally driven by the data 
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model. The loading of the meta model is strictly a reflection of what 
has been modelled in the meta_assembly table. 

Note the relationships between any predecessor and its successors 
are named and may optionally have a conditional expression on them. 
5 The condition expression is evaluated dynamically at run time. The 
condition must be evaluated to true in order for the relationship to 
exist. 

Objects & Relationships Modelled in Meta Model 

This section provides list of various objects and relashionships 
10 modelled in meta model. The list of objects and relashioships provided 
here covers most of the common scenarios which apply to most of 
network assemblies. It is important to understand that need for 
modelling new objects and relationships may arise in future depending 
on the assembly and the kind of support required in NETSMART for 
15 that assembly. Depending on the kind of support provided for an 
assembly, every relationships object may not be applicable. Following 
is the list of commonly modelled objects in meta model: 

• Shelves 

• Equipment 
20 • Facilities^ 

• Equipment Protection Groups 

• Facility Fibre Protection Groups 

• Functional Groups 

• Clocks 



25 ^ This includes all different types of facilities (e.g. ports, termina- 
tion points etc) which are required to be supported for the particular 
network element assembly. 



App'n of Fujitsu Network Communications, Inc.: FN'3014 



Page 158 



CPU 

In addition to that, there are some pseudo objects which can be 
modelled to organize the hierarchy better. These objects are Sections 
and Groups. Sections are primarily used to group related equipment 
together and Group is a more general notion to group set of related 
meta objects together in meta_assembly. Following is list of relation- 
ships modelled in meta model: 

CONTAINS Used to model containment between two objects. 

CONTAINS_ONE_OF If a parent object in the containment hierarchy 
can have only one of possible children (in dynamic view) then 
this relationship is used between parent object and individual 
children objects. 

CONTAINS ONE OF DEFAULT Used to relate a parent object to 

the child object which will be default child in case when multiple 

children objects are related to the parent by CON- 

TAINS ONE OF rela-tionship. 
IS_SUPPORTED_BY Used to capture relationship between functional 

groups and slots supporting those groups. 
HAS_WORKING_PARTICIPANT Used to capture relationship 

between a protection group (equipment or facility) and working 

object in that group. 
HAS_PROTECTING_PARTICIPANT Used to capture relationship 

between a protection group (equipment or facility) and protecting 

object in that group. 
SUPPORTS_PORT Used to capture relationship between port and 
equipment supporting that port. 

IS_XCONNECTABLE_TO Used to model the relationship between 
two time slot groups which can have cross con-nects between 
them. Used in case of FLASH 192 only at present. 
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IS_DEFAULT_XCONNECTABLE_TO Used to model the relation- 
ship between two time slot groups which can have cross connects 
between them by default. Used in case of FLASH 192 only at 
present. 

5 IS_DEFAULT_lWAY_XCONNECTABLE_TO Used to model the 
relationship between two time slot groups which can have one 
way cross connects between them by default. Used in case of 
FLASH 192 only at present. 
CONTAINS_AS_WORKING Used to model relationship between line 
10 termination point and working time slot groups contained in it. 

CONTAINS_AS_WORKING_DEFAULT Used to model relationship 
between line termination point and default working time slot 
:^ groups (if any) contained in it. 

ffi; CONTAINS_FOR_PROTECTING Used to model relationship 

Q 15 between line termination point and protecting time slot groups 

i=n contained in it. 

'•■D 

|L, Modelling Tips 

Ifi Following are some tips and guidelines for modelling of network 

!= elements: 

O 20 • MetaObjects to represent CPUs have to be named as <stringl >- 
''^ <string2> While < string 1> can be anything (usually "Cpu" 

or "CPU"), <string2> has to be the AID of the CPU. Because 
this is the logic used to get the CPU aid during a SWDL/RMBU! 
The existing metamodels follow this rule. 
25 • There are MetaObjects for which we will not create any application 
object in the dynamic tree. Exam-pies are PHYSICAL SIDE, 
LOGICAL SIDE, CPUs etc. You can give 'none' as their 
naming value in meta_instance.db Also make sure that you leave 
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the naming_key of the corresponding meta_component entry as 
empty. 

• Any MetaObject contained by another MetaObject that has been 

marked as 'expand' (ie, instancetype is 'expand' in 
meta instance.db) should itself be given the instance type 
'expand'. 

• Any MetaObject contained by another MetaObject that has been 

marked as 'collapse' (ie, instance type is 'collapse' in 
meta instance.db) should itself be given the instance_type 
'collapse'. 

• Make sure that CID+Type will be a unique key to identify a 

MetaObject. CID is the naming_value col-umn in meta_instance. 
And Type is the comm_type column in meta component. In 
other words, there should not be more than one MetaObject with 
the same CID and the same Type. 

• While assigning the meta attribute LINKABLE to MetaObjects, do 

NOT use any conditions. This is because when Topology queries 
CM for all linkable facilities, CM does a direct DB query by 
joining pnecomponent table with metamodel tables. Conditions 
cannot be evaluated during this. Again, existing metamodel does 
not use conditions for LINKABLE attr; so we can keep it that 
way. 

• Now we can assign meta attributes to meta component id's or 

meta instance id's. So it is better to keep these two ids distinct. 

• Use comments generously in the db files. It would be useful later 

on, if we can put the schema of the corresponding table at the 
beginning of each db file. 

• Try to organize the db files into different logical blocks. Use blank 

comment lines to visually separate diff blocks. Give useful 
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comments for each block. For examples, pi see FLM600/*.cib 
files. 

Conditions and their evaluation 

While modelling a network element assembly, conditions can be 
used where ever some concept is applicable based on condition. In 
current design following things can be qualified with conditions: 

• Relationship between two meta objects could be conditional. While 

meta model relationship tree tra-versal, relationships qualified 
with conditions are only traversed if the condition is met. 
Traversal logic does not reach a node, if there was a condition 
on its predecessor edge (i.e. relationship to parent) which is 
evaluated to 'false'. Similar logic applies to traversal from a 
child to parent object as well. This kind of conditional relation- 
ships are covered in meta assembly. 

• Applicability of an attribute to a Meta Component or Meta Instance 

could be conditional. An attribute and all its characteristics (e.g. 
vaild values, read only etc) will apply to a Meta Component or 
Meta Instance only if the associated condition (if any) evaluates 
to true. The conditions in meta model look like 
DataObject.getAttributeValueString("CONF5")= = "Dl" This 
implies that if the value of attribute 'C0NF5' is equal to 'DT in 
an object of class DataObject then this will evaluate to 'true'. In 
order to evaluate conditions, meta model needs 'context'. A 
component which invokes an interface on meta model, needs to 
provide context as well so that meta model can evaluate any 
related conditions. 'Context' is a generic concept and is a vector 
of objects. In the example of condition above, the 'context' is 
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expected to be a vector of DataObject'* objects. The framework 
component responsi-ble for evaluation of conditions, will invoke 
'getAttributeValueStringC'CONFS")' method on each object in 
con-text and compare the return value with 'Dl'. If there was 
5 any object in the context for which this comparison succeeds the 

condition will be evaluated to true. 

Autodiscovery Overview 

This section presents overview of the autodiscovery process and 
involvement of meta model in this process. When user adds a network 
10 element and performs 'login' from NETSMART GUI, ACT-USER 
TLl command is sent by NETSMART to log into the network element. 
Autodiscovery process is triggered, once successful login and some 
basic initialization is achieved. Autodiscovery process can be divided 
into three major phases as described below: 
15 1. Retrieving configuration information from the NE being 
autodiscovered - During this phase all con-figuration information 
is retrieved from network element by sending appropriate TLl 
commands for retrieval (e.g. RTR V-EQPT etc . ) . Communication 
Server provides interfaces to the application server for these TLl 
20 commands. As a result of invocation of these interfaces on 

COMMS, Application Server gets collection of dataobjects. 
COMMS returns one dataobject for each aid fetched from the 
network element. These dataobjects are created by COMMS after 
parsing the TLl responses. Each KEYWORD-DOMAIN pair in 
25 TLl response is translated to a Attribute-Value pair. Each 

dataobject contains collection of such Attribute-Value pairs. In 



^ Dataobject is a java class in NETSMART. 
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addition to collection of Attribute- Value pairs, dataobject also 
contains aid and ComponentlD^. During this phase information 
about all entities (i.e. equipment, facilities, EPGs etc) is 
retrieved from network element. This information retrieval is 
driven by DataCache. Their are subclasses of DataCache for 
each NE type supported by NETSMART. For example, there is 
FACTRDataCache which drives this information retrieval for 
FACTR NEs during Autodiscovery. It is responsibility of the 
meta model person who is modelling a new NE type to imple- 
ment a subclass of DataCache for that NE type. From the 
dataobjects received from COMMS, the DataCache build a 
hashmap of these dataobjects with CompinentID being the key. 
DataCache also supports interface to obtain a dataobject based on 
its ComponentID, which is used by Autodiscovery in second 
phase. 

2. Traversing the meta model relationship tree and creating application 
objects 2 - Once the DataCache has retrieved all the information 
and built a hashmap of dataobjects, Autodiscovery traverses the 
meta model relationship tree and creates application objects. 
These application objects are passed to Configuration Manager, 
which holds and manages them. The traversal starts from the 
root node and for every node following steps are taken to create 
application objects: 

• If the meta object is marked as auto_create (i.e. auto_create 



^ ComponentID is internal to NETSMART and can be treated as 
a unique identifier for a dataobject for a given TID. AddressTranslator 
in COMMS translates the aid in TLl response to corresponding 
COmponentID by following some predefined rules. 
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column in meta_instance is set to 'auto_create' for the 
meta object) then a default application 3 object is created 
for that meta object. 

• If the meta object is marked as normal (i.e. auto create 

column in meta instance is set to 'normal' for the meta 
object) then ComponentID for that meta object is obtained. 
If there is a dataobject for this ComponentID in the 
DataCache then an application object is created for the 
meta object using 

1 . ComponentID is internal to NETSMART and can 
be treated as a unique identifier for a dataobject for a 
given TID. AddressTranslator in COMMS translates the 
aid in TLl response to corresponding COmponen-tID by 
following some predefined rules. 

2. Application objects are held by Configuration 
Manager. Each application object hold reference to corre- 
sponding meta object and data object. 

3. In default creation a dummy data object is created 
in order, the dataobject otherwise no application object is 
created corresponding to the meta object. 

• If the meta object is marked default_create (i.e. auto_create 

column in meta instance is set to 'default create' for the 
meta object) then ComponentID for that meta object is 
obtained. If there is a dataobject for this ComponentID in 
the DataCache then an application object is created for the 
meta object using the dataobject otherwise a default 
application object is created. 
Configuration Manager builds a containment tree of application 
objects created by Autodiscovery. The containment relations in 
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this tree of application objects (also called as dynamic tree or 
dynamic view of the NE) are same as modelled in meta model. 
When autodiscovery passes an application object to configuration 
manager, it also passes reference of parent application object. 

Collapsed Meta Objects 

Collapsed Meta Objects are specialized Meta Objects which 
represent multiple objects of the same type. The behavior of a 
collapsed MetaObject similar to a standard MetaObject with one major 
difference. A standard MetaObject has a fiilly qualified ComponentID, 
invoking getCIDQ will return a complete ComponentID (e.g 
shelf = NBS- 1 : slot =CH-l:port= 3). However, a collapsed MetaObject 
can not return a fully qualified ComponentID because it represents 
multiple objects. For those RelativeComponentlDs that cannot be 
resolved, a wildcard value C*'), is returned (e.g. 
group = 1 : sts = 1 : vtg = * : vt = * , group = 4 : sts = 1 : vpi = 0 : vci = *) . 

However, any ComponentID will always resolve to a 
MetaObject. For example, ComponentID group= l:sts= l:vtg=2:vt=4 
will resolve to the MetaObject with ComponentID 
group= l:sts= l:vtg = *:vt = *. Note that ComponentID 
group=l:sts = l:vtg=3:vt=2 would also resolve to the same 
MetaObject. 

To determine if a MetaObject is a collapsed object, a new 
interface has been provided on MetaObject: isCoUapsedObjectO. 

A collapsed MetaObject can be designated as "expandable". 
Unlike the previous version of the MetaModel, expansion in this case 
does not mean replicating the MetaObject ntimes. Instead, the collapsed 
MetaObject will fully expand all possible ComponentlDs and that list 
of expanded CIDs can be retrieved via a new MetaObject interface 
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getAIUnstancesO- For collapsed MetaObjects not designated as 
"expandable", an attempt to retrieve all possible ComponentlDs will 
return an empty list. To detemine if a collapsed MetaObject is 
expandable an application can invoke the MetaObject interface: 

isExpandedObjectO • 

Summary of the interfaces changed or added on MetaObject.java 
to support collapsed objects: 

• ComponentID getCIDQ 

In the case of a normal MetaObject getCIDQ will return the fully 
resolved ComponentID. If it is a col-lapsed MetaObject, whether that 
MetaObject is expandable or not, the ComponentID returned will not 
be fully resolved. Wild card values will appear for those 
RelativeComponentlDs that could not be resolved. 

• boolean isCoUapsedObjectO 

Return true if the MetaObject is a collapsed object; false 
otherwise. 

• boolean isExpandedObjectO 

Returns true if the MetaObject is a collapsed object and its 
ComponentID can be fully expanded to all possible ComponentlDs. 

• Vector getAIUnstancesO 

If the MetaObject is a collapsed object and it can be expanded, 
then a list containing the fully expanded list of ComponentlDs is 
returned. Otherwise an empty list is returned. In most cases applica- 
tions will not care about whether the MetaObject is collapsed or not 
since all other interfaces remain unchanged. Applications that are most 
likely to be affected are those that create and main-tain the NE 
configuration (e.g. autodiscovery, configuration or provisioning 
changes). 
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Figure 34 shows architecture components for an embodiment of 
the disclosed innovations. Oracle databases are used for persistent 
storage, accessed via SQL (Structured Query Language). Lower 
applications interface to the databases through FDBC (Fujitsu DataBase 
Connectivity) and use FORA (Fujitsu Object Relational Adaptor) for 
mapping objects to the database. 

The network manager applications include topology (used to manage 
groups, NEs, and links), a software repository, a fault manager that 
manages fault for the network, raw TLl and TLl batch that provide 
raw TLl interfaces and batch capability, and software download and 
remote backup manager. 

The element manager applications include a meta model that describes 
an NE for a given release, autodiscovery that identifies and discovers 
NEs, configuration manager for the NEs, crossconnect manager that 
manages the NE crosscormects, a fault manager, and software 
download and remote backup manager for the NEs. 
The framework components include event service, query and client 
persistency which provides object query service and column query 
service to the client, transaction and concurrency which provides 
transaction services, security, thread which provides threading policy 
and CORE A request dispatching, connection (Life Cycle Service) 
which provides services for server activation, log and trace, directory 
naming service (used to locate server object), and cluster agent 
framework which provides HA services and process management. 
The communication subsystem includes a session manager that manages 
the TLl sessions to NEs, a session which provide TLl sessions to NEs 
and performs CORE A IDL to TLl command/response and autonomous 
message mediation, a raw session, an address manager that provides 
TID to network address mapping (source can be TARP or 
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NETSMART database), and an OSI. 
Process Architecture 

Figure 35 shows an overview of the process architecture for 
NETSMART. NETSMART process architecture is divided into 
5 CORBA services, Framework, Process Activation and Monitoring, 
AppHcation, and Communications. 

The CORBA services include Naming Service (provides name 
resolution service for NETSMART CORBA objects). Event Service 
(provides COS event channels for autonomous communication in 

10 NETSMART), and orbixd (orbix demon provides CORBA client/server 
connection management for the object request broker). 

The Framework core includes Framework and Security. 
Framework consists of a LogManager (provides high speed logging 
service to NETSMART application components). Broker (provides 

15 CORBA object location and activation services to application compo- 
nents), Client Persistency (provides remote persistency services to GUI 
client) and Client Query (provides remote Query service to GUI 
Clients). Security consists of a User Manager (provides management 
of NETSMART users). Access Control Manager (provides management 

20 of user security profiles to control access to NETSMART functional- 
ity), and User Session Manager (manages all active NETSMART 
sessions). 

Process Activation and Monitoring consists of the fenicsd and 
daemon monitor. NETSMART daemon processes monitor the health of 
25 all NETSMART processes, and identify process failure and restart 
them. The fenicsd an daemon monitor also monitor each other and 
relaunch of one of them dies. 

Optional application services include UPS manager (listens to 
trap notifications from the UPS for power down events, and manages 
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the shutdown of NETSMART under power failure conditions), emlnml 
server (provides an interface to NETSMART for NML systems), and 
performance management (collects performance data from the NES and 
persists them into Oracle database for later analysis. 

Core application services include the topology server (provides 
interfaces to manage NEs, groups, and links; provides services to 
establish raw TLl sessions to the NEs, and provides integrated network 
level fault query, management, and count service), the application 
server (various components of which perform the following: model the 
physical NE; manage NE configuration in databases; maintain the 
metadata for each type of NE managed by NETSMART; use static 
metamodel definition to instantiate NE specific objects by fetching 
information from the physical NE; identify discrepancies and reconcile 
the differences between the physical NE and the NETSMART view of 
the NE; manage crossconnects in database and the physical NE; and 
store the NEs faults in databases), and the software manager server 
(which provides services to manage software generics, provides NE 
level services to download and activate software generic, and 
back-up/restore of NE database; these interfaces are provided at the 
network level). 

Core communication services include the communication server 
(provides command/response/event and raw TLl sessions to the NEs, 
and provides IDL to TLl and vice-versa mediation), the session 
manager (manages conmiunication sessions to NEs and provides a 
lookup service from TID to NSAP/IP). Conmiunication may be 
provided via TARP (Target Address Resolution Protocol), FT AM (File 
Transfer and Access Management), and OSI standards. 

Figure 36 shows a hardware architecture for an embodiment of 
the presently disclosed innovations. The Enterprise-5 500/6500 
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configuration shows one example of hardware implementation for the 
server. The server networks with individual NEs by a 100 base-T NE 
communication network, and with client machines via a client 
communication network, using OSI and IP LAN cards respectively. 
5 The server also has an uninterruptable power supply (UPS) and an 
L280 Autoloader backup system connected by a small computer system 
interface (SCSI). This figure shows the framework, applications, and 
communications blocks of the server. Oracle database using redundant 
array of inexpensive disks (RAID) serves as persistent backup. 

10 Figure 37 depicts the server architecture for a given 

NETSMART application component. An application component (for 
example, topology server, communication server, etc.) interfaces with 
the Oracle database through FDBC and uses FORA for mapping 
objects to the database. FDBC uses JNI (Java Native Interface) to call 

15 OCI (Oracle Call Interface) functions. OCI functions are written in C 
and allow database manipulation and management. 

The thread filters define the threading semantics for a given 
application. Thread filters are used to deliver CORBA requests to 
CORBA objects. 

20 The utilities are available for various tasks. They include 

asyncworker (the worker thread pattern that executes user commands 
entered through the GUI), object pool (a pattern for optimal perfor- 
mance containing a pool of objects which can be reused), inventory 
(lists of related objects), licensing service (restricts usage of installation 

25 based on the NETSMART licensing purchased by the user), task 
management (pattern for multi-thread programming), and collection 
(extension and Java collection, generates collection objects to transmit 
over CORBA). 

The helpers include DNSHelper (Directory Naming Service, used 



App'n of Fujitsu Network Communications, Inc.: FN-3014 



Page 171 



to look up CORE A objects in NETSMART), authenticator (provides 
authentication services when users request restricted privileges), 
eventservice (asynchronous communication between various compo- 
nents in NETSMART), registry (lookup service for CORBA for objects 
in NETSMART), and log/trace (logging and tracing to NETSMART 
application components). 
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Definitions: 

Following are short definitions of the usual meanings of some of 
the technical terms which are used in the present application. 
(However, those of ordinary skill will recognize whether the context 
5 requires a different meaning.) Additional definitions can be found in 
the standard technical dictionaries and journals. 



The NETSMART terminology may have meanings that are slightly 
different from standard telephony terms. The terms used are defined 
below. 

10 Access identifier (AID)— AIDs are address information identifying a 
specific equipment slot or facility (traffic or overhead channel). 
Bidirectional line-switched ring (BLSR)— A BLSR is a ring that 
provides working and protection fibers between nodes. If the 
working fiber between nodes is cut, traffic is automatically 
15 routed onto the protection fiber. 

Common Language Equipment Identifier (CLEI ® )— CLEI is a 
standard code used by suppliers to identify equipment parts and 
system configurations. 
Correlation tag (CTAG)— CTAGs are required by TLl and are used 
20 to correlate the input TLl and response messages. 

Equipment protection group (EPG)— The EPG is used to establish 

the working/protection relationship between two cards. 
Equipment— Equipment consists of the NEs and related hardware 
within the telecommunications network. 
25 Facility— The facility is the fiber or copper transmission media used 
between NEs to transport telecommunications signals. 
Fiber facility protection (FFP)— FFP is used to establish a working/ 

App*n of Fujitsu Network Communications, Inc.: FN-3014 Page 173 



protection relationship between two or more facilities. 
Fujitsu minimum support NE— A Fujitsu NE that is not on the 

officially supported list but conforms to a basic set of TLl 

commands will be managed as a minimally supported Fujitsu 
5 NE. Support consists of logging on, adding links, displaying as 

an icon on the topology map, and displaying alarms. 
Group— Groups are logical associations of NEs to facilitate NE 

management. For example, NEs can be placed in a group based 

on location or type of NE. 
10 Tool Action/Function Previous Select Previous to return to the 

previous displayed topic. Next Select Next to reverse direction 

and return to the topic where you first used Previous, one topic 

at a time. Print Displays the Print dialog and allows you to print 

the on-line help. 

15 Link— A link is a communications channel or circuit that carries a 
telecommunications signal between two NEs. 
Logical link— The line displayed on the Topology window that depicts 
one or more physical connections between NEs and/or groups of 
NEs is referred to as a logical link. The line only represents the 

20 actual network and can be removed without affecting the 

network. Logical link names can be edited to conform to the 
customer's particular naming convention. 
NE— The term NE refers to hardware only or a combination hardware 
and software system that is primarily designed to directly 

25 perform a teleconmiunications service function. For example, an 

NE is the part of the network equipment where a transport entity 
(such as a line, path, or section) is terminated and monitored. 
Path— A path at a given rate is a logical connection between the points 
at which a standard frame format for the signal at the given rate 
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is assembled and disassembled. 

Physical link— The line displayed on the Display Link window that 
depicts a physical connection between the ports of two different 
NEs is referred to as a physical link. The line only represents the 
actual network and can be removed without affecting the 
network. Physical link names, which are in the format 
< TID > : < port > : : < TID > : < port > , are not editable. 

Port— In transmission control/Internet protocol (TCP/IP) and user data 
protocol (UDP) networks, this is an end point to a logical 
connection. The port number identifies what type of port it is. 
For example, port 80 is used for HTTP traffic. 

Synchronous Transport Signal Level 1 (STS-1)— The STS-1 signal 
is the basic logical building block of the SONET signal structure. 
It consists of lower-order signals, payload, and transport 
overhead for a combined signal rate of 51.84 Mb/s. 

Target identifier (TID)— TIDs uniquely identify NEs. Fujitsu NEs 
require from 7 to 20 alphanumeric characters. NETSMART 
allows from 1 to 20 alphanumeric characters to address non- 
Fujitsu NEs. 

Time-slot assignment (TSA)— TSA allows STS-1 level traffic to be 
added, dropped, or passed through a selected SONET NE. Time 
slots are assigned on a dedicated basis. Service (i.e., DSls 
and/orDS3s) is mapped into these dedicated time slots in the 
high-speed multiplexed signal. 

Unidirectional path-switched ring (UPSR)— A UPSR consists of a 2- 
fiber ring. The input signal is bridged in both directions to 
provide redundant bandwidth. If a fiber is cut or a disruption 
affects one direction, the signal is available from the other 
direction. 
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Virtual tributaries (VTs)— VTs are structures designed to transport 
and switch sub-STS-1 pay loads. There are currently four VT 
sizes: VT1.5 (VT container for a DSl in SONET), VT2, VT3, 
and VT6. 
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The preferred embodiment described above (Netsmart™) does not 
delimit the claimed inventions, but does provide a good indication of 
their advantages, and of the capabilities which can be included in a 
system implementing the claimed inventions. Netsmart™ combines 
5 features of both network management and element management layers 
of TMN model to provide comprehensive management capabilities. 
Netsmart™ can manage very large deployments (thousands of network 
elements, including both Fujitsu and non-Fujitsu elements) while 
supporting many active users. Netsmart™ provides a hierarchical view 

10 of the network from large scale configuration down to the shelf and 
card level, all with a GUI that displays the different scales. Several 
different views make it easier for managers to monitor and control 
what is going on in the system. Netsmart™ also provides graphical 
control over surveillance, provisioning, software download (SWDL), 

15 remote memory backup (RMBU), and remote memory restore (RMR). 
Netsmart™ also features a rich graphical user interface which allows 
user to perform operational tasks without entering data or TLl 
Commands. 

Modifications and Variations 

20 As will be recognized by those skilled in the art, the innovative 

concepts described in the present application can be modified and 
varied over a tremendous range of applications, and accordingly the 
scope of patented subject matter is not limited by any of the specific 
exemplary teachings given. 

25 Although the presently preferred embodiment has been imple- 

mented as an EMS which is designed to interface to an NMS, the 
disclosed innovations can be implemented with other choices as to the 
software hierarchy. For example, it is quite possible to combine an 
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NMS with EMS functionality, and the dividing line between EMS and 
NMS is not a sharp divide. Similarly numerous other functions (such 
as fault, configuration, account, performance, and/or security manage- 
ment) can be combined if desired with the primary functions of element 
management functions, and the disclosed inventions can be applied to 
such expanded architectures in various ways. 

The TMN standard describes an overall software architecture 
concept which interrelates the various components of telecommunica- 
tions system management, in addition to element management and 
neetwork management layers, layers are also reserved for business 
management and service management. Other functions can also be 
combined into this hierarchy. The disclosed innovations are not limited 
to a system which is solely an Element Manager System, but can also 
be applied to other systems which include element management 
functionality, even though such systems may not be EMS systems 
strictly speaking. 

None of the description in the present application should be 
read as implying that any particular element, step, or function is an 
essential element which must be included in the claim scope: THE 
SCOPE OF PATENTED SUBJECT MATTER IS DEFINED ONLY 
BY THE ALLOWED CLAIMS. Moreover, none of these claims are 
intended to invoke paragraph six of 35 USC section 112 unless the 
exact words "means for" are followed by a participle. 
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